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Introducción 


Bienvenido a la biblia de Java 2. Este libro se ha diseñado para que sea 
todo lo comprensible y accesible que es posible teniendo en cuenta que es un 
libro de Java. En él va a encontrar tanto Java como quepa en sus páginas. 

Java no es un lenguaje de programación ordinario: inspira devoción, pa- 
sión, exaltación y excentricidad (no se menciona exasperación ni frustra- 
ción). Esperemos que lo que Java tiene que ofrecer le resulte irresistible al 
igual que ha ocurrido con otros muchos programadores (de hecho, la progra- 
mación en Java es uno de los conocimientos más lucrativos que se pueden 
tener hoy en día). 

Al lenguaje de programación Java se le ha llamado "C++para Internet", y 
aunque hay algo de verdad en eso, Internet no es el único lugar en el que 
actualmente se encuentra Java. Cada vez hay más empresas que utilizan el 
lenguaje de programación Java para construir aplicaciones que no tienen 
relación con Internet, pero que tienen que ser independientes de la platafor- 
ma. He visto que muchas de las grandes corporaciones han cambiado gra- 
dualmente su programación interna de C++ a Java. La influencia del lenguaje 
de programación Java se está extendiendo y no hay visos de pararlo, y con 
cada versión se tiene más poder y más profundidad para trabajar con este 
lenguaje. 


Si está de acuerdo conmigo, se sentirá atraído por la programación en 
Java, ya que lo que puede hacer con este lenguaje es asombroso. Verá lo que 
quiero decir en cada una de las páginas de este libro. 


Contenido del libro 


Este libro está diseñado para mostrarle toda la historia del lenguaje de 
programación Java que un libro puede contener. Veremos no sólo toda la 
sintaxis de Java, desde la declaración de variables hasta temas de orientación 
a objetos avanzada, sino también el lenguaje Java en el mundo real. Se 
cubrirán temas como permisos de acceso a applets, uso del visualizador de 
Java, creación de conexiones clientelservidor sobre Internet, creación deJava 
Beans, conexión de bases de datos y multithread. 

En este libro se tratan cientos de temas, y cada uno de ellos viene con un 
ejemplo que muestra cómo funciona. Está dividido en temas separados y 
fácilmente accesibles y en cada uno de ellos se trata un caso de programación 
diferente. Algunos de estos temas son los que se muestran a continuación: 


toda la sintaxis de Java 2 

programación orientada a objetos 

herencia y clases internas 

abstract windowing toolkit (AWT) 

botones, casillas de activación y botones de opción 
selectores, listas y cuadros de lista desplegables 
gráficos, imágenes, texto y fuentes 

menús, cuadros de diálogo y ventanas 


barras de progreso, barras de desplazamiento, separadores y cuadros de 
desplazamiento 


tratamiento y ajuste de imágenes 
Java Swing 

cambios de apariencia con Swing 
todos los componentes Swing 
componentes de texto Swing 


colecciones Java 


e multithreads 

e flujos de E/S 

e manejo de ficheros 

e redes y sockets 

e árboles y tablas 

e Java Beans 

e paquetes, interfaces y ficheros JAR 
e seguridad 

e manejo de excepciones 


e manejo del teclado y del ratón 


Esta lista no es completa. Más adelante trataremos muchos temas más. 
Uno al que prestaremos especial atención y que no se trata en la mayoría de 
los libros, es Java Swing, la nueva y revolucionaria interfaz para la programa- 
ción de clases Java. 

Existe una norma que se usará en este libro y que deberá conocer: para 
resaltar una línea concreta de código, se sombreará de la siguiente forma: 


public class app 
{ 


public static void main (String[Í args) 


{ 


(new printer( )).print( )5 


Requerimientos 


En este libro, utilizará Java 2, versión 1.2.2. Si no usa esta versión como 
mínimo, puede que al ejecutar el código aparezcan algunos errores. Por ello, 
obtenga Java Development Kit (JDK) en http://java.sun.com/products/jdk/ 
1.2 (o la última versión). 

También necesitará tener una forma de crear programas Java. Estos pro- 
gramas son ficheros planos de texto con instrucciones y declaraciones Java. 
Para crear un programa Java, deberá tener un editor que permita guardar 
ficheros en formato texto. Para más detalles, vea el capítulo 1. 

Todo lo que necesita para usar este libro, además del editor de programas, 
lo puede obtener en el sitio Web de Sun Java, http://java.sun.com. JDK tiene 


todo lo que necesita para crear applets y aplicaciones estándares de Java e 
incluso posee un visualizador de applets para verlos mientras está trabajando. 

Además de JDK, usaré Beans Development Kit (BDK), y Java Servlet 
Development Kit (JSDK), que también se pueden obtener en el sitio Web de 
Java. Si quiere continuar con la programación de base de datos incluida en el 
libro, necesitará crear en su máquina una fuente de datos ODBC. En el CD 
encontrará la base de datos que trabaja con esta fuente de datos, junto con el 
código, imágenes y otros ficheros utilizados en el libro, sin mencionar un 
gran número de utilidades. 

Finalmente, Java le ofrece gran cantidad de documentación, cientos de 
libros de calidad. Esa documentación está almacenada en páginas HTML 
enlazadas y para trabajar con ellas y visualizarlas, necesitará tener un navegador 
Web. 


Otros recursos 


| 
Pa | 
dd 


Hay otros recursos Java que pueden servir de ayuda con el lenguaje de 
programación Java. Como se mencionó anteriormente, hay decenas de miles 
de páginas de documentación que vienen con el mismo lenguaje Java. Hay 
además muchas, muchas páginas Web referentes al lenguaje Java (haciendo 
una búsqueda aleatoria en la Web se encuentran unas 10.268.200 páginas que 
mencionan Java; de hecho, buscando "Java tutorial" se encuentran unas 
11.614 páginas). A continuación se citan algunos de estos recursos útiles: 


e página principal de Java en http://java.sun.com 
e guía didáctica de Sun Java en http://java.sun.com/docs/books/tutorial 


e soporte técnico en línea de Sun en http:l/java.sun.comlproducts/¡dW 
1.2/docs/index.html 


e para obtener el lenguaje de programación Java, ir a http://ava.sun.com/ 
products/¡dW1.2 


Entre otros temas, puede encontrar guías didácticas sobre los conceptos 
siguientes en la página de tutorías de Sun http://java.sun.com/dosc/books/ 
tutorial: 


e colecciones 
e internacionalización 


e servlets 


e gráficos 2D 

e seguridad en JDK 1.2 

e sonido 

e ficheros Java Archive (JAR) 

e Java Beans 

e Conectividad de bases dedatos Java (JDBC) 
e interfaz nativa de Java 

e llamada remota a métodos (RMI) 


e reflexión 


Además hay un número de grupos Usenet para programadores de Java, 
que incluyen: 


èa comp.lang.java. idwocacy 

* comp.lang.java.announce 

* comp. lang. javr. beans 

= comp.lang.java.corba 

* comp.lang.jova.databases 

* comp.lang.java.gul 

* còmp lang java help 

. comp lang java machine 

= comp. lang java programmer 

= comp. lang java.security 

* comp- lang java softwarciools 

Para Java existe mucha ayuda, pero espero que no tenga que acudir a ella. 
Este libro está diseñado para proporcionarle todo lo que necesite (y espero 


que así sea. Ahora es el momento de empezar a trabajar con Java, comenzan- 
do por el capítulo 1. 


M Java básico 


Bienvenido a nuestro gran libro de programación Java. En este libro, 
trararemos con detenimiento y detalle toda aquella programación Java que 
puede estar contenida en un libro. 

Como el propósito de este libro es poner a su disposición todo el lenguaje 
de programación Java, preparándole para usarlo, no dejaremos de lado los 
temas difíciles. Habrá algunos paquetes de programación con los que disfru- 
tará más que con otros, y espero que elija Java como plataforma de programa- 
ción. 

Este primer capítulo cubre los conocimientos fundamentales de Java que 
habrá que recordar para el resto de los capítulos. En los siguientes capítulos, 
verá la ejecución de código Java, pero ninguno es útil si no puede ejecutar y 
crear programas Java. Ese conjunto básico de conocimientos, la creación y 
ejecución de programas Java, es el tema de este capítulo, y en los siguientes 
podrá poner en práctica dicha información para ensayar la sintaxis Java que 
desarrollaremos. 

En este capítulo, vamos a trabajar con la mecánica de crear programas 
Java, desde la instalación hasta la escritura de código, desde asegurarse de 
que el programa es capaz de encontrar lo que necesita hasta visualizar una 
simple salida. Estos conocimientos son los que podrá usar en los siguientes 
capítulos. Estos se centran en todas las interioridades de la escritura de 


código Java; este capítulo trata el resto del proceso que hace que el código 
funcione. 

Ya debería conocer mucho sobre el contenido de este capítulo, en cual- 
quier caso se revisará con detenimiento (alguno de ellos está limitado por ser 
nuevo y a pesar de todo, muy poca gente sabe lo que la línea de comandos del 
compilador Java puede hacer). Si ya tiene una instalación de Java que funcio- 
na y puede escribir y ejecutar un programa básico en Java, ya está familiariza- 
do con la mayor parte de lo que verá en este capítulo. Por consiguiente, puede 
pasar rápidamente por las páginas siguientes y continuar con el capítulo 2, 
donde empezaremos a profundizar en la sintaxis de Java, lo que realmente 
hace que Java funcione. De lo contrario, trabaje con el contenido de este 
capítulo, pues proporciona la base para varios de los capítulos siguientes. 


Todo sobre Java 


¿De dónde procede el lenguaje de programación Java y por qué es tan 
popular? Como otros lenguajes de programación, Java satisfizo una necesi- 
dad específica de su tiempo. Antes de que Java apareciera, por ejemplo, C era 
un lenguaje extremadamente popular entre los programadores y parecía que 
era el lenguaje de programación perfecto, combinando los mejores elementos 
de los lenguajes de bajo y alto nivel en un lenguaje de programación que se 
ajustaba a la arquitectura del ordenador y que gustaba a los programadores. 

Sin embargo, el lenguaje C tenía limitaciones, al igual que los lenguajes 
de programación anteriores. Cuando los programas crecían, los programas C 
se hacían inmanejables porque no había una forma fácil de acortarlo. Esto 
quiere decir que el código de la primera línea de un programa largo podría 
interferir con el código de la última línea, y el programador tendría que 
recordar todo el código mientras programaba. 

La programación orientada a objetos se hizo popular por ser capaz de 
dividir programas largos en unidades semi-autónomas. El lema de la progra- 
mación orientada a objetos es "divide y vencerás”. En otras palabras, un 
programa se puede dividir en partes fácilmente identificables. Por ejemplo, 
supongamos que para mantener fresca la comida utilizara un sistema com- 
plejo. Debería comprobar la temperatura de la comida usando un termómetro, 
y cuando la temperatura fuera lo suficientemente alta, activaría un interruptor 
que arrancara el compresor e hiciera funcionar las válvulas para que el frío 
circulara; luego arrancaría un ventilador que moviera el aire. Esa es una 
forma de hacerlo. Sin embargo, otra consiste en coordinar todas esas opera- 
ciones de forma que sean automáticas, cubriendo todo con una unidad senci- 


lla, un refrigerador. Ahora las interioridades no se ven y lo único que hay que 
hacer es introducir o sacar comida del frigorífico. 

Así funcionan los objetos: ocultan los detalles de la programación al resto 
del programa, reduciendo todas las interdependencias que aparecen en un 
programa C e inicializando una interfaz bien definida y controlable que 
mantiene la conexión entre el objeto y el resto del código. Así usted puede 
pensar en el objeto como algo fácil, por ejemplo, puede tener un objeto que 
gestiona toda la interacción con la pantalla, un objeto al que le llame pantalla. 
Puede utilizarlo de distintas formas, que verá a lo largo de este libro, para 
manipular aquello en lo que pretende actuar (en este caso, la pantalla). Des- 
pués de crear ese objeto, sabe que la pantalla es gestionada por ese objeto y 
puede tenerlo en mente, pero en ninguna otra parte del código tendrá que 
gestionar el manejo de la pantalla, podrá usar en su lugar el objeto pantalla 
que ha creado. 

Cuando se añadió al lenguaje C la programación orientada a objetos, nació 
C++, y los programadores tuvieron un nuevo aliciente. C++ permite a los 
programadores tratar grandes programas, y el código orientado a objetos 
ayudó a resolver también muchos de los otros problemas. Por ejemplo, el 
hecho de soportar objetos lo hacía más fácil para los fabricantes que suminis- 
traban software con mucho código reutilizable, preparado para su uso. Para 
crear un objeto, utiliza una clase que actúa como una plantilla o creador de 
patrones para ese objeto. Se puede pensar en una clase como un tipo de 
objeto, al igual que una variable puede ser de tipo entero. 

Como C++ soporta clases, los proveedores de software pueden proporcio- 
narle enormes librerías de clases, a partir de las cuales se puede empezar a 
crear objetos. Por ejemplo, una de las librerías de clases de C++ más popula- 
res es la librería Microsoft Foundation Class (MFC) que viene con Visual 
C++ de Microsoft, y en ella los programadores encontraron una mejora tre- 
menda respecto a los tiempos pasados. Cuando se escribía un programa 
Windows en C, se necesitaban aproximadamente cinco páginas de código 
para visualizar una ventana vacía. Sin embargo, utilizando una clase de la 
librería MFC, simplemente había que crear un objeto del tipo de ventana que 
se quisiera usar: con o sin borde, como un cuadro de diálogo, etc. El objeto ya 
tenía toda la funcionalidad del tipo de ventana que quería crear, por lo que 
para crear una ventana sólo era necesaria una línea de código, la línea en la 
que se creaba el nuevo objeto ventana de la clase que se había seleccionado. 

Más impresionante todavía era el hecho de que se podía usar una clase 
MFC como clase base para las clases propias, añadiendo la funcionalidad que 
se quisiera por medio de la herencia de la programación orientada a objetos. 
Por ejemplo, supongamos que quiere que su ventana tenga una barra de 


menús; entonces puede derivar su propia clase de una ventana simple de 
MFC, añadiendo a esa clase una barra de menús para crear la clase nueva. De 
esta forma, añadiendo unas cuantas líneas de código a las de los programado- 
res de Microsoft, puede construir su propia clase. (En este libro verá en 
detalle cómo funciona la programación orientada a objetos). 

Todo esto parecía fabuloso a los programadores, y C++ llegó muy lejos. 
Parecía que el lenguaje de programación perfecto había llegado. ¿Qué podía 
haber mejor? Sin embargo, el mismo entorno de programación iba a verse 
sometido a un gran cambio con la popularización de lo que equivale a un 
nuevo e inmenso entorno de programación: la red Internet. Y eso es lo que 
hizo que Java fuera tan popular. 


Orígenes del lenguaje Java 


Originalmente, Java no fue creado para la red Internet. La primera versión 
de Java empezó en 1991 y fue escrita en 18 meses en Sun Microsystems. De 
hecho, en ese momento, ni siquiera se llamó Java; se llamó Oak y se utilizó 
en Sun para uso interno. 

La idea original para Oak era crear un lenguaje orientado a objetos inde- 
pendiente de la plataforma. Por entonces, muchos programadores se limita- 
ban a la programación del IBM PC, pero el entorno corporativo podía incluir 
toda clase de plataformas de programación, desde el PC hasta los grandes 
sistemas. Lo que había detrás de Oak era crear algo que se pudiera usar en 
todos los ordenadores ( y ahora que Java se ha hecho popular gracias a la red 
Internet, cada vez más corporaciones están adoptándolo para uso interno en 
lugar de C++, precisamente por esa razón). El lanzamiento original de Oak 
no fue especialmente fascinante; Sun quería crear un lenguaje que se pudiera 
usar en electrónica. 

Oak pasó a llamarse Java en 1995, cuando se lanzó para el uso público y 
supuso un éxito casi inmediato. En ese momento, Java había adoptado un 
modelo que lo hizo perfecto para la red Internet, el modelo bytecode. 


Todo c'obre bytecodes 


Un programa Visual C++ de Microsoft es grande, normalmente un progra- 
ma MFC puro no baja de 5MB sin incluir las librerías de enlace dinámico 
(DLLs) que la plataforma Windows necesita para ejecutar los programas 
Visual C++. En otras palabras, los programas C++ son completamente 
ejecutables en el ordenador en el que residen, lo que justifica que tengan un 
gran tamaño. Imaginemos que intentamos descargar todo eso como parte de 
una página Web para permitir que esa página haga algo interactivo en su 
ordenador. 


Los programas Java, porel contrario, se construyen de forma diferente. El 
propio lenguaje Java está implementado como la máquina virtual de Java 
(JVM), que es la aplicación que actualmente ejecuta un programa Java. Cuan- 
do JVM se instala en un ordenador, éste puede ejecutar programas Java. Los 
programas Java, por lo tanto, no necesitan ser autosuficientes, y no tienen por 
qué incluir todo el código máquina que se ejecuta en el ordenador. En cam- 
bio, los programas Java son compilados creando bytecodes compactos y son 
estos bytecodes lo que JVM lee e interpreta para ejecutar el programa. Cuan- 
do descarga una applet Java de la red Internet, lo que realmente está descar- 
gando es un archivo de bytecodes. 

De esta forma, su programa Java puede ser muy pequeño, ya que todo el 
código máquina necesario para ejecutarlo está ya en el ordenador de destino y 
no tiene que descargarse. Para distribuir Java entre una gran variedad de 
ordenadores, Sun sólo tuvo que rescribir JVM para que funcionara en esos 
ordenadores. Dado que su programa está almacenado en un archivo de 
bytecode, se ejecutará en cualquier ordenador en el que JVM esté instalado. 

Aunque en un principio se suponía que los programas Java eran interpreta- 
dos por JVM, es decir, ejecutados bytecode por bytecode, la interpretación 
podía ser un proceso lento. Por esta razón, Java 2 incorpora la compilación al 
instante Just in Time (JIT) en JVM. El compilador JIT realmente lee los 
bytecodes por secciones y los compila de forma interactiva en lenguaje má- 
quina, por lo que el programa puede ejecutarse más rápido ( todo el programa 
Java no se compila de una vez, ya que Java va realizando comprobaciones en 
tiempo de ejecución en varias secciones del código). Desde su punto de vista, 
esto quiere decir que su programa Java se ejecutará más rápido con el nuevo 
compilador JIT. 

Utilizar bytecodes significa que los programas Java son muy compactos, 
lo que les hace ideales para descargarlos en la red Internet. Y otra ventaja a la 
hora de ejecutar tales programas con JVM, mayor que la descarga de progra- 
mas, es la seguridad. 


La seguridad del lenguaje Java 


Cuando se ejecuta un programa, JVM puede monitorizar estrictamente lo 
que va ocurriendo, lo cual es importante para las aplicaciones de la red Internet. 
Fuera de toda duda, la seguridad ha llegado a ser un asunto extremadamente 
importante en la red Internet, y Java se ha lanzado a esa tarea. JVM puede ver 
todo lo que un programa hace, y si hay algo dudoso, como puede ser tratar de 
escribir en un archivo, puede preveniresa operación. Eso sólo hace que, para 
la red Internet, Java sea más atractivo que C++, que no tiene tales restricciones. 


Además se puede configurar la seguridad de Java de la forma que se desee, 
ofreciendo una solución muy flexible. Por ejemplo, como verá en este libro, 
ahora puede especificar, tomando como base programa por programa, aque- 
llos privilegios que quiera dar para descargar código. Además, ahora puede 
firmar su código Java de forma que muestre de dónde procede para evitar 
modificaciones malévolas. Echaremos un vistazo a todo esto y más alo largo 
de este libro. 

Como puede observar, Java tiene una baza ganada en la red Internet: los 
programas Java son pequeños, seguros, independientes de la plataforma, 
orientados a objetos, y potentes. Además presentan otras características que 
gustan alos programadores. Los programas Java son robustos (lo que signifi- 
ca que son fiables y pueden gestionar bien los errores), con frecuencia son 
sencillos de escribir comparados con C++ son multihilo (pueden ejecutar un 
número de tareas al mismo tiempo, lo cual es útil cuando se quiere continuar 
haciendo otras cosas mientras se espera a que un archivo de datos se descar- 
gue, por ejemplo) y ofrecen un alto rendimiento. El resultado final es que se 
puede escribir un programa Java una vez y puede descargarse fácilmente y 
ejecutarse en todo tipo de máquinas, la receta perfecta para la red Internet. 
Esta es la razón por la que Java ha llegado tan alto. 

Java no tiene como único objetivo a la red Internet; de hecho, hay dos 
tipos de programas Java, uno para el uso de la red Internet y otro para el uso 
en máquina local. 


Programas Java 


Los programas Java son de dos tipos principales: aplicaciones y applets. 
(En este libro utilizaré el término programa para referirme aapplets y aplica- 
ciones). Las applets son programas Java que pueden descargarse y ejecutarse 
como parte de una página Web, y son las que han hecho que Java sea tan 
popular. Por ejemplo, puede ver una applet en funcionamiento en la figura 
1.1, donde la applet se está ejecutando en Microsoft Internet Explorer y 
visualiza un saludo. 

La mayor parte de los navegadores Web han sido algunas veces lentos a la 
hora de implementar las versiones más recientes de Java, por lo que en este 
libro, usaré el visualizador de applets de Sun que viene con Java. Encontrará 
esta utilidad, llamada appletviewer (con una extensión según sea requerida 
por el sistema, como appletviewer.exe en Windows), en el directorio bin de 
Java junto con otras utilidades Java que usaremos en este y algunos de los 
siguientes capítulos. Puede ver el visualizador de applets funcionando en la 
figura 1.2, mostrando la misma applet que la figura 1.1. 


IHOla desde Javal 


Figura 1.2. Una applet en funcionamiento con el visualizador de applets de Java. 


Además de applets descargables, Java soporta aplicaciones que están dise- 
ñadas para ejecutarse localmente. Las aplicaciones Java funcionan como 
otras aplicaciones de ordenador, puede instalarlas y ejecutarlas en el suyo. Al 
estar instaladas localmente en vez de ser descargadas con una página Web, 
las aplicaciones tienen más privilegios que las applets, como es la capacidad 
para leer y escribir archivos. 

Las aplicaciones que usaremos en los siguientes capítulos serán el tipo 
más sencillo de aplicaciones Java: aplicaciones consola. Son aplicaciones 
basadas en texto que se ejecutan desde la línea de comandos (en Windows 
esto quiere decir desde una ventana DOS), y pueden leer y visualizar texto. 
En este capítulo comprobará cómo tales aplicaciones funcionan. Por ejemplo, 
podrá decir que tiene una aplicación Java llamada app que visualiza el mensa- 
je "¡Hola desde Java!" (acaba de ver cómo lo hace la applet). En este caso, la 
aplicación visualizará este mensaje en la pantalla. Ejecute la aplicación arran- 
cando la máquina virtual de Java con el comando Java, pasándole el nombre 
de la aplicación que quiere ejecutar. En Unix, sería así, donde '%' es el 
command prompt: 


%java app 
¡Hola desde Java! 


En Windows, sería así: 


c:X>java app 
¡Hola desde Java! 


¿Las aplicaciones Java pueden ser gráficas? Realmente pueden serlo, y de 
hecho, la mayoría de ellas lo son. En este caso, la aplicación es responsable 
de arrancar su propia ventana (el visualizador de applets lo hará). En la figura 
1.3 puede ver una aplicación ventana de Java. 


¡Hola desde Javal 


Figura 1.3. Una aplicación ventana en ejecución. 


¿Es Java 2 o Java 1.2? 


La última área que hay que revisar antes de empezar es la versión actual de 
Java. Puede que haya oído decir que Sun renombró Java 1.2 como Java 2, 
pero esto es sólo verdadero en parte. El paquete actual de Java, que será el 
que usemos, Java Development Kit (JDK), que incluye el compilador Java, 
JVM y otras utilidades, se llama oficialmente Java 2 JDK, versión 1.2. Por lo 
tanto, aunque me referiré a la versión actual de Java como Java 2, verá aún 
referencias a la versión 1.2; de hecho, se encontrará con alguna de estas 
referencias en la siguiente sección. 

Para una visión general ya es suficiente; es hora de empezar a crear 
programas Java y de ver cómo avanza. 


Adquirir e instalar Java 


El gran jefe le llama, como es usual, en el último minuto. Tiene 20 
minutos para escribir una nueva página Web que permita a los usuarios tener 
una visión general de los productos de su compañía. ¿Qué va a hacer? Cono- 
ciendo lo bien que funciona Java en casos como este, selecciona Java como 
lenguaje para realizar esa tarea. Por supuesto, se ha asegurado de tenerlo 
antes de poder utilizarlo. 

Es hora de descargar e instalar Java, lo que significa descargar Java 
Development Kit (JDK),que está disponible en http://java.sun.com/products/ 
jdW1.21 (1.2 se refiere a la versión de JDK, que ahora se llama Java 2 
Development Kit, versión 1.2.2 en el momento de escribir este manual). 

Después de descargar JDK, generalmente como un paquete ejecutable 
autoinstalable, seguir las instrucciones de instalación en el sitio Web 
java.sun.com; por ejemplo, las instrucciones de instalación en Windows es- 
tán en http://java.sun.comlproducts/¡dW1.2/install-windows.html, y para 
Solaris se encuentran en http://java.sun.com/products/jdk/1.2/install- 
solaris.html. 

Estaría encantado de proporcionar aquí las instrucciones de instalación, 
pero esa es una de las mayores trampas en las que un libro de Java puede caer, 


iiri 


incluso uno que haya sido diseñado para ser lo más completo posible. Llevo 
escribiendo sobre Java desde sus orígenes y se ha demostrado que las instruc- 
ciones de instalación son muy volátiles. Como esas instrucciones cambian, 
las que incorporé en los libros anteriores se quedaron obsoletas al instante, 
dando lugar a gran cantidad de llamadas y cartas. Por esa razón, lo mejor que 
se puede hacer es ver cómo Sun quiere que se instale JDK, y por consiguien- 
te, debería acudir a las instrucciones de instalación que se encuentran en el 
sitio Web de Java. El proceso de instalación se ha ido haciendo cada vez más 
fácil en las diferentes versiones y ahora sólo consiste en ejecutar el archivo 
que se ha descargado. 

Algo que se debería hacer, como indican las instrucciones de instalación 
de Sun, es asegurarse de que su máquina es capaz de localizar las herramien- 
tas de Java, incluyendo el compilador. Para hacer eso, verificar que el direc- 
torio bin de Java está en la ruta de acceso de su ordenador. Por ejemplo, en 
Windows 95/98, el directorio bin es c:\jdkl.2.2\bin para JDK 2, versión 
1.2.2, y basta con añadir una línea como esta (asegúrese de que están inclui- 
dos en la ruta de acceso todos los directorios que quiere utilizar) en el 
archivo autoexec.bat: 


SET PATH=C:XWINDOWS;C:XJDK1.ZZ21BIN 


Además, debe volver a arrancar su ordenador para que los cambios tengan 
efecto. Cuando el directorio bin esté en la ruta de acceso, podrá utilizar las 
herramientas de Java directamente desde la línea de comandos, en lugar de 
tener que invocarlas con toda la ruta de acceso cada vez. 


¿Qué ocurre con CLASSPATH? 


Los veteranos en Java se preguntarán por la variable de entorno llamada 
CLASSPATH cuando instalen Java2. La variable CLASSPATH, como vere- 
mos pronto en este capítulo, dice a Java donde encontrar los archivos bytecode 
compilados, tanto los que creó como los del sistema que vienen con JDK. 
CLASSPATH ha sido el foco de grandes confusiones al trabajar con Java y 
estoy contento de decir que Cun ha facilitado las cosas. 

Cuando instale JDK, ya no tiene que preocuparse de poner la variable 
CLASSPATH, porque JDK sabrá dónde buscar sus propias librerías. Sin 
embargo, si quiere buscar otros archivos bytecode creados al compilar un 
archivo, tendrá que poner la variable CLASSPATH. Verá cómo hacer esto 
cuando discutamos la compilación de programas en este capítulo (hay dos 
formas de indicar al compilador de Java dónde buscar los archivos bytecode 


que quiere encontrar: poniendo la variable de entorno CLASSPATH y usan- 
do la opción del compilador -classpath). 

En Java 2 hay muchas novedades. Sin embargo, Java 2 también tiene 
algunas cosas obsoletas, en Java llamadas censuradas, y es importante saber 
lo que es obsoleto y lo que es nuevo. De hecho, echaremos un vistazo a lo que 
era nuevo en Java 1.1 para servir de utilidad a los programadores que proce- 
den de Java 1.0. Veamos este tema a continuación. 


¿Cuáles son las novedades de Java 1.1? 


El programador novato (PN) comienza, como es usual, buscando ayuda. 
"He utilizado Java 1.0", dice el PN, "y estaba pensando en actualizarlo a Java 
1.1". "Bien", responderá , "la versión actual es la 2". El PN ignora eso y 
pregunta, "¿Cuáles son las novedades de Java 1.1?" "Bien", dirá, "muchas 
cosas, tome una silla y las iremos viendo". 

Probablemente el mayor cambio entre Java 1.0 y 1.1 fue la forma en que 
los programas Java gestionaban los eventos. Un evento ocurre cuando el 
usuario ejecuta alguna acción significativa en la interfaz de usuario, como 
pulsar un botón, mover el ratón o pulsar una tecla (veremos todo sobre las 
viejas y nuevas técnicas de gestión de eventos en el capítulo 6). La nueva 
técnica en Java 1.1 y 2 utiliza el modelo de eventos delegado, y es bastante 
diferente de cómo se hacía en Java 1.0. Tan diferente, de hecho, que si intenta 
ejecutar un programa Java que usa el modelo de evento delegado en un 
navegador Web que sólo soporta el modelo de evento de Java 1.O, el proceso 
se detendrá. (En cambio, todavía podrá usar las técnicas antiguas de gestión 
de eventos en Java 1.1 y 2, pero el rendimiento de los programas se verá 
degradado). 

Hubo muchos cambios en Java 1.1. A continuación se enumeran los más 
importantes (observar que algunos de estos temas no tienen mucho sentido 
ahora pero estarán más claros a lo largo del libro): 


e Mejoras en Abstract Windowing Toolkit (AWT). Java 1.1 soportaba la 
impresión, más rapidez en los desplazamientos, menús emergentes, el 
portapapeles, un modelo de eventos basado en la delegación, mejoras 
en las imágenes y gráficos y más temas. Además, era más rápido que 
antes (algo que los programadores de Java podían apreciar de forma 
definitiva). 


e Archivos JAR. Los archivos JAR (archivo Java) permiten empaquetar 
un número de archivos, comprimiéndolos para reducir su tamaño y 


permitiendo la descarga de muchos archivos a la vez. En un archivo 
JAR se pueden poner muchas applets y los datos que necesiten, de 
forma que se descargue mucho más rápido. 


Internacionalización. Se pueden desarrollar applets locales, utilizando 
caracteres UNICODE, mecanismo local, soporte de mensajes locales, 
fecha sensible a la localidad, hora, zona horaria y más. 


Applets firmadas y firmas digitales. Se pueden crear aplicaciones Java 
con firmas digitalizadas. Una firma digital permite a los usuarios dar 
marcha atrás en el caso de que algo vaya mal. Esto forma parte de las 
nuevas precauciones de seguridad de la red mundial (World Wide Web). 


Método remoto de llamada (RMI). Permite que los objetos Java tengan 
métodos que son llamados desde el código Java que se ejecuta en otras 
sesiones. 


Objetos en serie de objetos. Permite almacenar objetos y gestionarlos 
con flujos binarios de entradalsalida. Permite almacenar copias de los 
objetos que se van a serializar, y además es la base de la comunicación 
entre objetos incluidos en RMI. 


Reflexión. Permite al código Java examinar la información sobre los 
métodos y constructores de clases cargadas, así como hacer uso de esos 
métodos reflejados y constructores. 


Clases internas. Hay clases encerradas en otras clases y el uso de las 
clases internas hace que sea más fácil crear clases adaptadoras. Una 
clase adaptadora es una clase que implementa una interfaz que es 
requerida por un API (interfaz de programación de aplicaciones). Utili- 
zando las clases adaptadoras se facilita la gestión de eventos, como 
veremos más tarde. 


Interfaz de un nuevo método nativo de Java. El código nativo es un 
código que se escribe específicamente para una máquina particular. La 
escritura y la llamada a código nativo puede mejorar significativamente 
la velocidad de ejecución. Java 1.1 incluía un nuevo método nativo de 
interfaz. 


Clases de tipo byte y short. Los valores de tipo byte y short pueden ser 
gestionados como números "envueltos" cuando se usan las nuevas 
clases de tipo Byte y Short. 


JavaBeans. Son componentes Java que pueden conectarse con otros 
programas Java. Es una nueva característica muy potente. 


La mayoría de los métodos de Java 1.0 han quedado obsoletos con Java 
1.1, y están marcados como censurados en la documentación de Java 1.1. 
Además, el compilador Java da un aviso cuando se compila el código que 
utiliza algo censurado. Ver el siguiente tema para más información. 


¿Qué está censurado en Java 1.1 ? 


"¡Eh!," dice el programador novato, "actualizo a Java 1.1 ahora, y mi 
código es erróneo. Por ejemplo, ahora estoy teniendo errores cuando utilizo 
la clase Date de Java". "Eso es porque gran parte de la clase Date fue censu- 
rada en Java 1.1 "dice. 

La mayor parte de las características de Java 1.0 se censuraron en Java 1.1, 
muchas más que la lista que aquí mostramos. Puede encontrar una lista de 
todo lo que se censuró en Java 1.1 en http://java.sun.com/products/ijdW 1.11 
docs/relnotes/deprecatedlist .html.Sin embargo, observe que esta lista no le 
será muy útil si usa Java 2, como haremos en este libro; en cambio vea el 
tema "¿Qué está censurado en Java 2?", que viene a continuación. 


¿Cuáles son las novedades de Java 2? 


"De acuerdo", dice el programador novato, "usted gana. Está claro que, 
debería actualizar a Java 2, no a Java 1.1. Entonces, ¿cuáles son las noveda- 
des de Java 2?" "Muchas cosas", dice. "Mejor tomemos un café". "Justo 
cuando ya me había habituado a Java 1.1Wse queja el programador novato. 

A continuación verá las novedades de Java 2 (observe que como en la lista 
mostrada en "¿Cuáles son las novedades de Java 1.1?", no tiene que estar 
familiarizado ahora con los conceptos, pero los verá más tarde en este libro): 


e Mejoras en la seguridad. Ahora, cuando el código está cargado, se 
asignan permisos basándose en las políticas de seguridad que actual- 
mente tienen efecto. Cada permiso indica que se tiene un acceso permi- 
tido a un recurso particular (como acceso de lectura y escritura a un 
archivo o directorio concreto, acceso para conectarse a un host o puerto, 
etc.). La política que especifica qué permisos están disponibles para el 
código de varios firmantesllugares, puede ser inicializada desde un 
archivo externo configurable. A menos que un permiso sea garantizado 
explícitamente, no se puede acceder al recurso que está protegido por 
ese permiso. 


Swing (JFC). Forma parte de las clases Java Foundation (JFC). 
Implementa un nuevo conjunto de componentes GUI de tipopluggable. 
Swing está implementado en Java puro y está basado en JDK 1.1 
Lightweight Ul Framework. El carácter pluggable permite diseñar un 
conjunto sencillo de componentes GUI que pueden automáticamente 
tener la apariencia de cualquier plataforma (por ejemplo, Windows, 
Solaris y Macinstosh). 


Java 2D (JFC). El API Java 2D es un conjunto de clases para gráficos 
2D e imágenes. Engloba el conjunto de líneas, texto e imágenes en un 
modelo sencillo y extenso. 


Accesibilidad (JFC). Por medido del API de accesibilidad de Java, los 
desarrolladores pueden crear aplicaciones Java que interactúen con 
tecnologías asistenciales, tales como lectores de pantalla, sistemas de 
reconocimiento de voz y terminales Braille. 


Arrastrar el cursor y soltar (JFC). Permite la transferencia de datos 
entre Java y aplicaciones nativas, entre aplicaciones Java y en el interior 
de una aplicación Java sencilla. 


Colecciones. El API de colecciones Java es un armazón unificado para 
representar y manipular colecciones Java (verá más sobre ellas más 
tarde), permitiéndoles ser manipulados independientemente de los deta- 
lles de su representación. 


Framework de extensiones Java. Las extensiones son paquetes de clases 
Java (y el código nativo asociado) que los desarrolladores de aplicacio- 
nes pueden usar para heredar el núcleo de la plataforma Java. El 
mecanismo de herencia permite que la máquina virtual de Java (JVM) 
utilice las clases heredadas de la misma forma que JVM utiliza las 
clases del sistema. 


Mejoras en JavaBeans. Java 2 proporciona a los desarrolladores un 
método estándar para crear componentes y aplicaciones JavaBeans más 
sofisticados que ofrecen a sus clientes una integración limpia con el 
resto del entorno de ejecución, como el escritorio del sistema operativo 
o del navegador. 


Framework para las entradas. Permite que todos los componentes de los 
editores de texto reciban textos en japonés, chino o coreano a través de 
los métodos estándar de entrada. 


Paquete de identificación de versiones. Las aplicaciones y las applets 
pueden identificar (en tiempo de ejecución) la versión de un entorno de 
ejecución Java específico, JVM y paquete de clases. 


Mejoras RMI. El método remoto de llamada (RMI) tiene varias mejo- 
ras, incluyendo la activación remota de objetos, que introduce el sopor- 
te de objetos remotos y la activación automática de objetos, así como 
configurar los tipos de socket, que permite a un objeto remoto especifi- 
car el tipo de socket configurado que RMI usará para llamadas remotas 
a ese objeto. RMI, sobre un transporte seguro (como SSL), puede ser 
soportado usando tipos de socket configurados. 


Mejoras en la serializadión. La serialización ahora incluye un API que 
permite que los datos serializados de un objeto sean especificados 
independientemente de los campos de la clase. Esto permite que los 
campos de datos serializados se escriban y se lean desde un flujo de 
datos usando las técnicas existentes (esto asegura la compatibilidad con 
los mecanismos de escritura y lectura establecidos por defecto). 


Objetos referencia. Un objeto referencia encapsula una referencia a 
algún otro objeto para que la referencia, por sí misma, pueda ser 
examinada y manipulada como cualquier otro objeto. Los objetos refe- 
rencia permiten a un programa mantener una referencia a un objeto que 
no impide al objeto ser regenerado por el reciclador, el cual gestiona la 
memoria. 


Mejoras en el audio. Las mejoras en el audio incluyen una nueva 
máquina de sonido y soporte para el audio en aplicaciones y enapplets. 


Java IDL. Java IDL incorpora la capacidad de CORBA (Common 
Object Request Broker Architecture) a Java, proporcionando la 
interoperabilidad y conectividad basada en estándares. Java IDL permi- 
te que las aplicaciones Java Web distribuidas invoquen de forma trans- 
parente operaciones o servicios de red remotos usando el estándar de la 
industria OMG IDL (Object Management Group Interface Definition 
Lunguage) e IIOP (Internet Inter.-ORB Protocol) definido por el Grupo 
de Gestión de Objetos. 


Mejoras en JAR. Estas mejoras incluyen la funcionalidad añadida a la 
herramienta JAR de la línea de comandos para crear y actualizar archi- 
vos JAR firmados. Hay además nuevas APIs estándares para leer y 
escribir archivos JAR. 


Mejoras en JNI. La interfaz nativa Java es una interfaz de programación 
estándar para escribir métodos nativos de Java y embeber la máquina 
virtual de Java en aplicaciones nativas. El primer objetivo es la compa- 
tibilidad binaria de librerías de método nativo a través de todas las 
implementaciones de la máquina virtual Java en una plataforma dada. 


Java 2 extiende el JNI incorporando nuevas características en la plata- 
forma Java. 


+ JVMDI. Una nueva interfaz de debugger para la máquina virtual de 
Java proporciona ahora servicios de bajo nivel para el debug. La interfaz 
para estos servicios es la interfaz Debugger de la máquina virtual de 
Java (JVMDD. 


e Mejoras JDBC. La conectividad Java de bases de datos (JDBC) es una 
interfaz estándar de acceso a base de datos que proporciona un acceso 
uniforme a un amplio abanico de bases de datos relacionales. JDBC 
además proporciona una base común en la que se pueden construir 


interfaces y herramientas de alto nivel. Java 2 incluye JDBC y el enlace 
JDBC-ODBC. 


En Java 2 también es nuevo el Javaplug-in. Este software es un producto 
que permite a los usuarios dirigir applets de Java o componentes JavaBeans 
para que se ejecuten en el entorno Java (JRE) de Sun, en lugar del entorno de 
ejecución del navegador Web que viene por defecto con Java. Esto se tratará 
en el capítulo 6. 


¿Qué se censuró en Java 2? 


"¡Eh!", dice el programador novato, "ya he actualizado a Java 2 y mi 
código sigue siendo defectuoso, no consigo que la parte de mi código en la 
que utilizo multihilos funcione del todo". "Eso es porque no puedes utilizar 
los métodos resume, suspend y stop de la clase Thread de Java,", dice. "Se 
han censurado". "iVaya!," protesta el programador novato. 

Uno de los cambios más importantes de Java 2 es que no se trabaja con 
hilos como se hacía en Java 1.1; verá las nuevas formas en el capítulo que 
trata multihilos más tarde en el libro. Para una lista completa de lo que se ha 
censurado en Java 2, ir a C:1jdk1.2.21docslapildeprecated-list .htmlHaré men- 
ción a alguno de los temas censurados más importantes en Java 2 a lo largo 
del libro. 


Escribir código: creación de archivos de código 


El coordinador del equipo de diseño (CED) le llama para felicitarle por la 
instalación de Java. Usted acepta los agradecimientos. "¿Qué programas se 
han escrito?" pregunta el CED. "Hmm", piensa. "¿Programas?" 


Los programas Java son archivos de texto planos formados por instruccio- 
nes y declaraciones Java, y empezaremos a investigarlos en el siguiente 
apartado. Para crear un programa Java, debería tener un editor o procesador 
de texto que permita guardar archivos en formato de texto plano. 

Guardar texto en formato de texto plano es una ejecución sencilla quela 
mayor parte de los procesadores de texto soportan. Podría tener problemas 
con procesadores de texto como Microsoft Word, por ejemplo, aunque puede 
guardar archivos de texto con Wordejecutando el comando Guardar como del 
menú Archivo. La regla general es que si al editar un archivo desde la línea de 
comando no se ve ningún carácter que no sea alfanumérico suelto, se trata de 
un archivo de texto plano. La prueba real, por supuesto, es que el compilador 
de Java, que traduce su programa en un archivo de bytecode, pueda leer e 
interpretar dicho programa. 

Además, los programas deben estar almacenados en archivos que tengan 
extensión "java". Por ejemplo, si está escribiendo una aplicación llamada 
app, debería guardar el programa Java en un archivo llamado app.java. Pase 
este archivo al compilador de Java para crear el archivo de bytecode, como 
verá en las siguientes páginas. 

Ya tenemos la selección del editor o procesador de textos. Ahora, ¿qué 
pasa con la escritura del código? 


Escribir código: conocer las palabras reservadas 
de Java 


El programador novato aparece y dice, "Java se está comportando de 
forma graciosa, quiero llamar a una variable "public" y me está dando mu- 
chos problemas". "Eso es porque public es una de las palabras que Java 
reserva como parte del lenguaje Java", le dice. "ivaya!", dice el programador 
novato. 

Cuando esté escribiendo código Java, debería saber que Java reserva cier- 
tas palabras clave como parte del lenguaje. No hay muchas, de cualquier 
modo. A continuación se muestran (trataré estas palabras clave a lo largo del 
libro): 


e abstract: Especifica la clase o método que se va a implementar más 
tarde en una subclase. 


e boolean: Tipo de dato que sólo puede tomar los valores verdadero o 
falso. 


break: Sentencia de control para salirse de los bucles. 

byte: Tipo de dato que soporta valores en 8 bits. 

byvalue: Reservada para uso futuro. 

case: Se utiliza en las sentencias switch para indicar bloques de texto. 
cast: Reservada para uso futuro. 

catch: Captura las excepciones generadas por las sentencias try. 


char: Tipo de dato que puede soportar caracteres Unicode sin signo en 
16 bits. 


class: Declara una clase nueva. 

const: Reservada para uso futuro. 

continue: Devuelve el control a la salida de un bucle. 

default: Indica el bloque de código por defecto en una sentencia switch. 
do: Inicia un bucle do-while. 

double: Tipo de dato que soporta números en coma flotante, 64 bits. 
else: Indica la opción alternativa en una sentencia If. 

extends: Indica que una clase es derivada de otra o de una interfaz. 


final: Indica que una variable soporta un valor constante o que un 
método no se sobrescribirá. 


finally: Indica un bloque de código en una estructura try — catch que 
siempre se ejecutará. 


flota: Tipo de dato que soporta un número en coma flotante en 32 bits. 
for: Utilizado para iniciar un bucle for. 

future: Reservada para uso futuro. 

generic: Reservada para uso futuro. 

goto: Reservada para uso futuro. 


If: Evalúa si una expresión es verdadera o falsa y la dirige adecuada- 
mente. 


implements: Especifica que una clase implementa una interfaz. 


import: Referencia a otras clases. 


inner: Reservada para uso futuro. 


instanceof: Indica si un objeto es una instancia de una clase específica o 
implementa una interfaz específica. 


int: Tipo de dato que puede soportar un entero con signo de 32 bits. 
interface: Declara una interfaz. 
long: Tipo de dato que soporta un entero de 64 bits. 


native: Especifica que un método está implementado con código nativo 
(específico de la plataforma). 


new: Crea objetos nuevos. 

null: Indica que una referencia no se refiere a nada. 
operator: Reservado para uso futuro. 

outer: Reservado para uso futuro. 

package: Declara un paquete Java. 


private: Especificador de acceso que indica que un método o variable 
sólo puede ser accesible desde la clase en la que está declarado. 


protected: Especificador de acceso que indica que un método o variable 
sólo puede ser accesible desde la clase en la que está declarado (o una 
subclase de la clase en la que está declarada u otras clases del mismo 
paquete). 


public: Especificador de acceso utilizado para clases, interfaces, méto- 
dos y variables que indican que un tema es accesible desde la aplicación 
(o desde donde la clase defina que es accesible). 


rest: Reservada para uso futuro. 


return: Envía control y posiblemente devuelve un valor desde el méto- 
do que fue invocado. 


short: Tipo de dato que puede soportar un entero de 16 bits. 


static: Indica que una variable o método es un método de una clase (más 
que estar limitado a un objeto particular). 


super: Se refiere a una clase base de la clase (utilizado en un método o 
constructor de clase). 


switch: Sentencia que ejecuta código basándose en un valor. 


Ar 


e synchronized: Especifica secciones o métodos críticos de código 
multihilo. 


e this: Se refiere al objeto actual en un método o constructor 
e throw: Crea una excepción. 
e throws: Indica qué excepciones puede proporcionar un método, 


e transient: Especifica que una variable no es parte del estado persistente 
de un objeto. 


e try: Inicia un bloque de código que es comprobado para las excepciones. 


e var: Reservado para uso futuro. 


e void: Especifica que un método no devuelve ningún valor. 
e volatile: Indica que una variable puede cambiar de forma asíncrona. 


e while: Inicia un bucle while. 


Escribir código: crear una aplicación 


El gran jefe llega y dice, "Ya puede escribir Java, ¿no? ¡Hágame una 
demostración!" Usted se va hacia la terminal e inmediatamente su mente se 
queda en blanco. ¿Qué va a escribir? 

A continuación hay un ejemplo de aplicación Java que se desarrollará en 
las siguientes secciones del libro, así como los estados de compilación y 
ejecución. Escriba este código en un archivo llamado app'java: 


public class app 
( 


public static void main(String[] args) 


( 
System.out.println(-oladesde Java!'"); 


1 


Si es nuevo en Java, esto puede que le resulte extraño. La idea es que esta 
aplicación visualice el texto "¡Hola desde Java!" cuando se compile y se 
ejecute. Por ejemplo, así sería en una ventana DOS desde Windows: 


C:MX>java app 
¡Hola desde Java! 


No se trata de uno de los programas más significativos, pero sí es bueno 
para empezar. Veamos este programa línea por línea. 


public class app 


Esta es la primera línea de app-java: 


public class a99 
{ 


Esta línea indica que estamos creando una clase de Java nueva llamada 
app. Después de que esta clase la transformemos en bytecodes, la máquina 
virtual de Java podrá crear objetos de esta clase y ejecutarlos. Aprenderá todo 
sobre las clases en el capítulo 4; este código es sólo para empezar con la 
programación Java. 

Observe la palabra clave public en el código anterior. Esta palabra es un 
especificador de acceso, sobre la que aprenderá más en los capítulos 4 y 5. El 
especificador de acceso public indica que esta clase está disponible en cual- 
quier parte del programa que la utilice. 

Observe además que si construye una clase pública, Java le obliga a dar un 
nombre al archivo. Es decir, sólo puede tener una clase pública en un archivo 
con extensión ".javaWLa razón de esto es que el compilador de Java traduce 
el archivo de extensión ".javan en un archivo bytecode con la extensión 
"class", lo que significa que app'java se convertirá en app.class, y si JVM 
necesita la clase app, sabrá cómo mirar en el archivo app.class. Dado que 
JVM utiliza el nombre del archivo para determinar las clases públicas que 
hay en él, sólo se puede tener una en cada archivo. Por esa razón, el código 
para la clase app debe estar en un archivo llamado app.java (observe que Java 
es bastante particular en esto, y el uso de mayúsculas hay que tenerlo en 
cuenta). 

La implementación de la clase que estamos definiendo ahora, estará entre 
llaves: 


public class app 
í 


Java siempre encierra bloques de código entre llaves, es decir, '(' y 'P'. 
Como verá en el capítulo 4, el código de un bloque tiene su propio alcance (su 
visibilidad para el resto del programa). A partir de ahora, continuaremos 
construyendo nuestra aplicación siguiendo con la siguiente línea de código. 


public static void main[String][] args) 


Esta es la siguiente línea de código de nuestra aplicación: 


public class app 
{ 


public static void main (String[l arga) 


{ 


Aquí estamos creando un método de la clase app. Un método en la progra- 
mación orientada a objetos es como una función o subrutina en la programa- 
ción estándar, un bloque de código al que se le puede pasar el control y que 
puede devolver un valor. Los métodos permiten manejar fácilmente el código 
en una unidad funcional sencilla; cuando llama a un método, la máquina 
virtual de Java ejecuta el código de ese método. 

Los métodos serán tratados formalmente en el capítulo 4, pero aquí la idea 
es que estamos creando un método llamado main, que es el método que la 
máquina virtual de Java busca cuando inicia una aplicación (las applets no 
tienen método main). Cuando encuentra el método rnain, JVM le pasa con- 
trol, y nos situamos en la parte del código que queremos ejecutar de este 
bloque de código del método. 

Antes de continuar hay varias cosas que observar. El método main debe 
declararse con el especificador de acceso public, lo que quiere decir que 
puede ser llamado desde fuera de su clase. También debe declararse como 
static, que significa, como veremos en el capítulo 4, que main es un método 
de una clase, no un método de un objeto. Cuando se termine de ejecutar, no 
debe devolver ningún valor, por lo cual usamos la palabra void en este código 
(en otras palabras, un valor de retorno de tipo void significa que actualmente 
no devuelve valor). Finalmente, observe el argumento entre paréntesis que 
sigue a la palabra main: String[] args. Aparece una lista de argumentos entre 
paréntesis en la declaración de un método para indicar que los valores se le 
pasan al método y que el código del método puede usarlo. En este caso, 
estamos indicando que a main se le pasa un array cuyos elementos son 
cadenas de caracteres, llamado args. Estos elementos son valores que se 
pasan desde la línea de comandos cuando se inicia la aplicación; por ejemplo, 
si escribe 'Ijavaapp Hola ahí", entonces "Hola" y "ahí" serían las dos cadenas 
del array args. Todos los detalles se mostrarán en el capítulo 4. Dado que no 
usaremos ningún argumento desde la línea de comandos en esta aplicación, 
no usaremos args en el código del método main. 


Esta línea de código, entonces, inicia el método main. Todo el trabajo de 
este método es visualizar el texto "¡Hola desde Java!",lo que se realizará en 
la siguiente línea de código. 


System.out.printin("¡Hola desde Java! "); 
El método main tiene una línea de código: 


public class app 
I 


public static void main(String[] args) 


( 
System.out.println("iHola desde Java!"); 


1 
> 


Esta es la línea de código que hace todo el trabajo. En este caso, estamos 
usando el código que los programadores de Sun ya han creado para visualizar 
el texto "¡Holadesde Java!". En particular la clase System del paquete java.lang. 
En Java, las librerías de clases se llaman paquetes y el paquete java.lang está 
en todo programa Java, lo que quiere decir que no hay que hacer nada 
especial para utilizarlo, a diferencia de otros paquetes Java. La clase System 
del paquete java.lang incluye un campo (es decir, un miembro de datos de la 
clase) llamado out, y este campo, a su vez, tiene un método llamado println, 
que hace que se visualice el texto. 

Para referirse al campo out de la clase System, usamos la terminología 
Systern.out. Para utilizar el método println del campo out, usamos la termi- 
nología System.out.println. Para imprimir el texto "¡Hola desde Java!", se lo 
pasamos a System.out.println cerrándolo entre comillas. 

Observe además que esta línea de código termina con un punto y coma 
(3). Esto es algo que Java ha heredado de C y C++ (de hecho, Java ha 
heredado muchas cosas de C y C++), y casi todas las sentencias de Java se 
terminan con punto y coma. Si no está acostumbrado a ello, lo conseguirá 
rápidamente, ya que el compilador de Java rechaza la traducción a bytecodes 
hasta que el punto y coma esté en su sitio. 

Por lo tanto, hemos creado una nueva aplicación y la hemos almacenado 
en un archivo llamado app.java. ¿Cuál es el siguiente paso? Ejecutarlo. Eche- 
mos un vistazo al siguiente tema. 


Compilación 


El gran jefe, mascando un cigarro, permanece de pie detrás de usted 
mientras guarda la nueva aplicación Java en un archivo. "Hmm", dice el gran 


jefe, nada impresionado. "¿Yahora?" "Ahora", dice, "tenemos que compilar 
el programa y ya podremos ejecutarlo". "De acuerdo," dice el gran jefe. 
"Sorpréndame". 

Para traducir un programa Java a un archivo bytecode que la máquina 
virtual de Java pueda utilizar, usará el compilador de Java, que se llama javac 
(por ejemplo, en las máquinas Windows, este programa se llamará javac.exe, 
que está en el directorio bin de Java). A continuación se indica cómo usará 
javac en general: 


javac [opciones] [archivos fuente] [farchivos] 


Argumentos de javac: 


e opciones: Opciones desde la línea de comandos. 

e archivos fuente: Uno o más archivos que se van a compilar (como 
app-java). 

e Oarchivos: Uno o más archivos de la lista de archivos fuente. 


Para compilar app.java, usaremos este comando: 


C: \javac app. java 


El compilador de Java, javac, toma el archivo app.java y (suponiendo que 
no haya errores) lo compila, traduciéndolo y creando un nuevo archivo Ilama- 
do app.class. Si hubiera errores, el compilador de Java nos avisará de que hay 
errores incluyendo qué línea de código está mal, como en este caso en el que 
hemos olvidado el métodoprintIn e intentamos usar uno llamado printline: 

C:\javac app.java 

app.java:5: Method printline (java.lang.String) not found in class 
java.io .Print 

Strearn. 


System.out.printline("iHola desde Java!"); 
1 error 


Cuando app.java está compilado sin errores, el nuevo archivo, app.class, 
contiene todo l0que la máquina virtual de Java necesitará para crear objetos 
de la clase app. Ya hemos creado app.class. Ahora, jcómo lo ejecutamos en 
JVM? Veamos el siguiente punto. 


Compilación: utilizando opciones en la línea de 
comandos 


"Hmm", dice el programador novato, "tengo un problema. Me gusta guar- 
dar todos mis archivos con extensión ".class" en el mismo directorio, pero 


algunas veces se me olvida copiar las nuevas versiones de esos archivos en 
ese directorio". "Hay una opción del compilador que es perfecta para eso: la 
opción —d. Usando esa opción, puede situar los archivos creados por el 
compilador en el directorio de destino que quiera". "Entonces, sólo tengo que 
acordarme de utilizar esa opción..., dice el programador. 

Hay un buen número de opciones que se pueden usar con javac. Por 
ejemplo, indicaremos cómo usar la opción -d para situar el archivo app.class 
en el directorio temp., que ya-existe que, en este caso, es un subdirectorio 
del directorio actual: 


javac -d Temp. app. java 


A continuación se muestra la lista de opciones de javac. Observe que las 
opciones que empiezan con -X (llamadas opciones no estándar) están marca- 
das de esa forma por Sun ya que pueden cambiar en el futuro: 


e -classpath ruta de acceso. Establece la ruta de acceso del usuario, 
sobrescribiéndola en la variable de entorno CLASSPATH. Si no se 
especifica CLASSPATH ni -classpath, la ruta de acceso es el directorio 
actual. Observe que si no se usa la opción -sourcepath, la ruta de acceso 
se busca tanto para los archivos fuentes como para los archivos de clase. 


* -d directorio. Fija el directorio de destino de los archivos de clase. Para 
los lectores que sepan qué son los paquetes Java, si una clase forma 
parte de un paquete, javac pone el archivo de clase en un subdirectorio 
que refleja el nombre del paquete, creando los directorios necesarios. 
Por ejemplo, si especifica -d ciclases y la clase se llama com.packagel. 
Class1, el archivo de clases se llama c:\clases\com\package1\Classl .class. 
Si no se especifica la opción —d, javac pone el archivo de clases en el 
mismo directorio que el archivo fuente. Observe que el directorio 
indicado por -d no se añade automáticamente a su ruta de acceso de 
clases. 


e -deprecation. Muestra una descripción de cada uso o sobrescritura de un 
miembro o clase censurado. (Sin -deprecation, javac sólo muestra los 
nombres de los archivos fuente que usan o sobrescriben miembros o 
clases censurados). 


* -encoding. Fija el nombre codificado del archivo fuente. Si no se 
especifica -encoding, se usará el convertidor por defecto de la plataforma. 


e -g. Genera todo la información de debugging, incluyendo variables 
locales. Por defecto, sólo se genera el número de línea e información 
del archivo fuente. 


-g:none. Hace que el compilador no genere ningún tipo de información 
de debugging. 


-g:(lista de palabras reservadas). Sólo genera algunos tipos de informa- 
ción de debugging, especificados por la lista de palabras reservadas 
separadas por coma. Las palabras válidas son source (información de 
debugging del archivo fuente), lines (información de debugging del 
número de línea) y vars (información de debugging de las variables 
locales). 


-nowarn. Deshabilita todos los mensajes de aviso. 


-O. Optimiza el código para la ejecución en términos de hacer más 
rápido el tiempo de ejecución. Observe que utilizar la opción -O puede 
ralentizar la compilación, producir archivos de clase más grandes y 
hacer que el programa sea difícil de poner a punto. Observe que antes de 
tener JDK 1.2, las opciones -g y -O no podían usarse juntas. Con JDK 
1.2, puede combinar -g y -O, pero puede obtener resultados inespera- 
dos, como pérdida de variables o de código. 


-sourcepath ruta de acceso de fuentes. Especifica la ruta de acceso de las 
fuentes para las definiciones de clases o de interfaces. Al igual que con 
la ruta de acceso de clases, las entradas se separan por punto y coma 
(';') y pueden ser directorios, archivos Java (con extensión ",jarWy 
archivos zip. Si usa paquetes, el nombre local de la ruta de acceso 
dentro del directorio o del archivo debe reflejar el nombre del paquete, 
como verá más tarde. Observe que las clases buscadas en la ruta de 
acceso de clase serán recompiladas automáticamente si sus archivos de 
código fuente no se encuentran. 


-verbose. Crea la salida "verbose". Incluye información sobre cada 
clase cargada y de cada archivo fuente compilado. 


-X. Visualiza información sobre las opciones no estándares. 


-Xdepend. Busca todas las clases que pueden ser utilizadas por los 
archivos fuente más recientes para recompilar. Esta opción descubrirá 
clases que necesitan serrecompiladas, pero puede ralentizar enorme- 
mente el proceso de compilación. 


-Xstdout. Envía mensajes del compilador a System.out. Por defecto, los 
mensajes del compilador van a System.err, que verá más tarde. 


-Xverbosepath. Describe las rutas de acceso y las extensiones estándar 
que fueron localizadas para buscar archivos fuente y de clases. 


e -Joption. Usa esta opción para pasar una opción al lanzador de Java 
llamado por javac. Por ejemplo, -J-Xms64m fija la memoria de inicio a 
64 MB. Aunque esta opción no empieza con —X, no es una opción 
estándar de javac. Es una convención para pasar opciones a las aplica- 
ciones escritas en Java que se están ejecutando en JVM. 


Opciones de compilación cruzada 


Las opciones de compilación cruzada se consideran un tema avanzado de 
Java; javac soporta la compilación cruzada, en la que las clases se compilan 
mediante un proceso autosuficiente (por defecto) y la implementación de 
extensión de clases. Se debe utilizar -bootclasspath y -extdirs cuando se esté 
hablando de compilación cruzada. A continuación se indican las opciones de 
compilación cruzada: 


e -target versión. Genera los archivos de clase que trabajará en JVM con 
la versión indicada. Por defecto se generan archivos de clase que son 
compatibles con JVM 1.1 y 1.2. Las versiones soportadas por javac en 
JDK 1.2 son 1.1 (asegura que los archivos de clase generados serán 
compatibles con JVM 1.1 y 1.2; esto es por defecto) y 1.2 (genera 
archivos de clase que se ejecutarán en JVM 1.2 pero no en JVM 1.1). 


e -bootclasspath ruta de acceso de arranque. Realiza la compilación cru- 
zada contra el conjunto de clases de arranque indicadas. Al igual que 
con la ruta de acceso de clases, estas entradas están separadas por punto 
y coma (';') y pueden ser directorios, archivos con extensión W .jar'o 
archivos zip. 


e -extdirs directorios. Realiza la compilación cruzada contra los directo- 
rios indicados; los directorios están separados por punto y coma (';'). 
Cada archivo con extensión ".jarWie los directorios indicados es locali- 
zado automáticamente por los archivos de clase. 


Compilación: revisión de los métodos 
censurados 


"Bueno", dice el programador, "¡cómo puedo cambiar todos los métodos 
censurados para que sean correctos? Ahora que ya estoy en Java 2, no sé lo 
que es obsoleto y lo que no". "Eso es fácil", responde. "El compilador de 
Java, javac, le dirá si está usando un método que ya ha sido abandonado. 


Mejor aún, puede usar la opción -deprecation para asegurarse de tener todos 
los detalles". 

La opción -deprecation es buena, y es la opción estándar que utilizo para 
asegurarme de que estoy evitando los métodos obsoletos. Supongamos que 
tiene un programa de 200 líneas, y que cuando lo intenta compilar, javac le 
devuelve este resultado: 


C:iljavac app. java 

Note: app.java uses or overrides a deprecated API. Recompile with "- 
deprecation" for details. 

1 warning 


Esto no es de mucha ayuda. Sin embargo, utilizando la opción -deprecation, 
puede conocer el problema exacto: 


C: \>javac app.java -deprecation 
app.java:109: Note: The method java.awt.Dimension size0 in class 
java.awt .Component has been deprecated. 

x= (size0.width - fontmetrics.stringWidth (text) )/2; 


Note: app.java uses or overrides a deprecated API. Please consult 
the documentation for a better alternative. 
1 warning 


Como puede ver, el problema es que app.java utiliza el método size en la 
línea 109 y ese método es obsoleto. Si se reemplaza por el método de la nueva 
versión, getSize, se resuelve el problema. 


Ejecución del código 


El gran jefe se está poniendo impaciente. Ha escrito usted una nueva 
aplicación y la ha compilado sin errores a la primera (de lo que puede sentirse 
orgulloso), pero realmente no ha ocurrido nada que el gran jefe pueda ver. Es 
hora de ejecutar la nueva aplicación. 

Las aplicaciones Java se ejecutan con el programa llamado java (en 
Windows, por ejemplo, es el archivo java.exe del directorio bin de Java). El 
programa java, llamado utilidad java, es lo que realmente ejecuta JVM. A 
continuación puede ver cómo usar la utilidad java: 


java [opciones] clase [parámetro ...l 
java [opciones] -jar archivo.jar [parámetro ...l 


Estos son los parámetros de las líneas anteriores: 


e opciones. Opciones de la línea de comandos, que se verán en otro 
apartado. 


e clase. Nombre de la clase a la que se llama. 


e archivo.jar. Nombre del archivo de archivo Java (JAR) al que se llama. 
Se usa sólo con -jar. Los archivos JAR se tratan en el capítulo 23. 


e Parámetro. Un parámetro de la línea de comando que se pasa al método 
main. 


Por ejemplo, para ejecutar la aplicación llamada app, que está en el archi- 
vo app.class, podría ejecutar el siguiente comando en la línea de comandos 
(observe que se omite la extensión".class" de app.class): 


java app 
El resultado aparecerá inmediatamente: 


java app 

¡Hola desde Java! 

En la figura 1.4 puede ver cómo funciona en una ventana DOS bajo 
Windows. 


Eso es todo. Ya ha escrito, compilado y ejecutado su primera aplicación. 
¡Felicidades! 
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Figura 1.4. Ejecución de una aplicación en una ventana DOS. 


Observe que si su aplicación no responde o si quiere pararla por alguna 
razón, puede pulsar Control-C. Si no funciona, inténtelo con la tecla Esc. 

Además, en este libro, verá cómo crear aplicaciones ventana, y cuando 
ejecute una de estas aplicaciones con la utilidad java, obtendrá los resultados 
que aparecen en la figura 1.5. 

Hay algo que hacer notar sobre la figura 1.5; la ventana consola (aquí una 
ventana DOS) está por debajo y espera que la aplicación termine antes de 


= 
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continuar (es decir, antes de que elprompt de DOS aparezca en este caso). Si 
no quiere que una ventana consola esté asociada con su aplicación ventana, 
puede utilizar la utilidad javaw, como se indica: 


javaw app 


Figura 1.5. Ejecución de una aplicación ventana. 


A continuación se indica cómo se utiliza javaw en general, igual que la 
utilidad java: 


javaw [opciones] clase [parámetro ..1l 
javaw [opciones] -jar archivo.jar [parámetro...l 


Estos son los parámetros utilizados con javaw: 


+ opciones. Opciones de la línea de comandos, que trataremos próxima- 
mente. 


e clase. Nombre de la clase a la que se llama. 


e Archivo.jar. Nombre del archivo de archivo Java (JAR) al que se llama. 
Se usa sólo con -jar. Los archivos JAR se tratan en el capítulo 23. 


e Parámetro. Un parámetro de la línea de comandos pasado al método 
main. 


Cuando usted lanza una aplicación ventana de Java como esta, la ventana 
consola no espera a que la aplicación termine; si la está ejecutando en DOS, 
la aplicación aparece y el prompt DOS reaparece en la ventana DOS. Esto da 
un sentido más profesional a estas aplicaciones. 

De hecho, hay otro lanzador en Java 2, el lanzador oldjava, que Sun 
incluyó para la compatibilidad hacia atrás. Este lanzador no soporta el 
framework de extensiones Java (ver el punto "¿Cuáles son las novedades de 


Java 2?"). Proporciona compatibilidad hacia atrás cuando tiene una aplica- 
ción que utiliza el estilo de seguridad de Javal. 1, que es incompatible con las 
técnicas de carga de clases de 1.2 (o quizás las clases que se están cargando 
han sido generadas o cambiadas de alguna forma que es incompatible con la 
estructura de clases de 1.2). En este libro estoy siguiendo Java 2, por lo que 
no se usará mucho el oldjava, pero si está migrando a Java 2 y necesita usar el 
mecanismo de carga de clases antiguo, es bueno saber que está ahí. También 
hay una utilidad oldjavaw. 

Asíes como puede ejecutar una aplicación, usando cualquier utilidad de 
Java: java, javaw u oldjava. Cuando lance una aplicación java2, el compilador 
Just In Time (JIT) compila los bytecodes y ejecuta la aplicación. 


Mientras estemos en'el tema de compilar y ejecutar el código, hay otro 
detalle que deberíamos tratar: las opciones de la línea de comando que se 
pueden usar con los comandos javac y java. Les echaremos un vistazo en los 
dos apartados siguientes. 


Ejecución de código: utilizar las opciones de la 
línea de comandos 


"Bien," dice el programador, "tengo otro problema. He almacenado todos 
mis archivos con extensión ".class" en un directorio, pero no quiero estar 
cambiando a ese directorio para ejecutarlos". "Otro problema fácil de resol- 
ver," le dice. "Puede usar la opción -classpath dela utilidad java o establecer 
la variable de entorno CLASSPATH para que el compilador de Java busque 
las clases correctamente". 


Echaremos un vistazo al uso de las opciones de la línea de comandos en 
este punto. Utilizará estas opciones.con las utilidades java, javaw y oldjava, 
de la siguiente forma (para ver información sobre estas utilidades, ver la 
sección "Ejecución del código," ya tratado en este capítulo): 


java [opciones] clase [parámetro...l 

java [opciones] -jar archivo.jar [parámetro...]l 
javaw [opciones] clase [parámetro...l 

javaw [opciones] -jar archivo.jar [parámetro...l 
oldjava [opciones] clase [parámetro...]l 

oldjavaw [opciones] -jar archivo.jar [parámetro...! 


A continuación se citan las opciones de la línea de comandos que puede 
utilizar con estas herramientas (observe que las opciones no estándar, que 


quiere decir que en un futuro puede que no estén soportadas, empiezan con 
una X): 


e -classpath ruta de acceso o -cp ruta de acceso. Especifica una lista de 
directorios, archivos con extensión".jar" o archivos con extensión".zip" 
para localizar archivos de clase. Se separan las entradas con punto y 
coma (';'). Observe que al especificar cualquiera de estas dos opciones 
se está borrando lo que indique la variable de entorno CLASSPATH. 
Utilizadas con java o javaw, -classpath o -cp sólo especifican la ruta de 
acceso para las clases de usuario. Usadas con oldjava u oldjavaw, 
especifican la ruta de acceso para las clases de usuario y las de arranque. 
Si no se especifican ni -classpath ni -cp y CLASSPATH no está, la ruta 
de acceso a las clases de usuario está limitada al directorio actual, que 
está referenciado con un punto ('.'). Ver el apartado "Conocimientos 
básicos: búsqueda de clases Java con CLASSPATH," más adelante en 
este capítulo para más información. 


e -Dproperty=valor. Fija un valor de propiedad del sistema. 


e -jar. Ejecuta un programa encapsulado en un archivo JAR. El primer 
parámetro es el nombre de un archivo JAR en vez de un nombre de clase 
de inicio. Cuando usa esta opción, el archivo JAR es la fuente de todas 
las clases de usuario y el resto de las rutas de acceso a otras clases de 
usuario se ignoran. Las herramientas oldjava y oldjavaw no soportan la 
opción -jar. 

e -verbose o -verbose:clase. Visualiza información sobre cada clase que 
está cargada. 


e -verbose:gc. Informa sobre cada evento de la colección garbage. Esta 
colección realiza la gestión de memoria en Java. 


e -verbose:jni. Da información sobre el uso de métodos nativos (es decir, 
específicos de la plataforma) y otras actividades de la interfaz nativa de 
Java. 


e -version. Visualiza información sobre la versión y se cierra. 
e -? o -help. Visualiza información de ayuda y se cierra. 
e -X. Visualiza información sobre las opciones no estándares. 


e -Xbootclasspath:ruta de acceso de arranque. Especifica una lista de 
directorios separados por punto y coma (';'), archivos con extensión 
"jar" o archivos con extensión ".zipVpara localizar los archivos de la 
clase de arranque. Observe que estos serán utilizados en lugar de los 
archivos de las clases de arranque que Java incorpora. 


e -Xdebug. Inicia con el debugger habilitado. 
e -Xnoclassgc. Deshabilita la colección de clases garbage. 


e -Xmsn. Indica el tamaño de memoria inicial que se quiere utilizar (este 
valor debe ser mayor que 1000). Para multiplicar el valor por 1000, 
añadir la letra 'k'. Para multiplicar el valor por un millón, añadir la letra 
'm'. El valor por defecto es lm. 


e -Xmxn. Especifica el tamaño máximo de memoria (este valor debe ser 
mayor que 1000). Para multiplicar el valor por 1000, añadir la letra 'k”. 
Para multiplicar el valor por un millón, añadir la letra 'm'. El valor por 
defecto es 64m. 


Xrunhprof[:help][:csubopción>=cvalor>,...l, Habilita el seguimiento 
de la CPU, la pila o del monitor. Esta opción va seguida normalmente 
por una lista de pares separados por coma (',') de la forma 
<subopción>=<valor>. 


e -Xrs. Reduce el uso de las señales del sistema operativo. 


e Xcheck:jni. Ejecuta tratamientos adicionales para las funciones de la 
interfaz nativa de Java. 


e -Xfutrue. Ejecuta un seguimiento estricto del formato de archivo de 
clases. 


Conocimientos básicos: comentar el código 


La persona encargada de la corrección del programa entra y le mira con 
reproche. "¿Qué ocurre?, pregunta. "Su código", dice. "No puedo imaginar lo 
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que ahí está escrito". "Lo siento, olvidé comentarlo", dice. "Le pido que lo 
haga", dice él. "Arréglelo"., 

A veces, el código puede ser muy críptico y difícil de descifrar. Por ello, 
Java le permite comentar su código para explicar a todo el mundo que lo lea 
cómo funciona el programa y lo que hace. Como ejemplo, añadamos comen- 
tarios a la aplicación que ya hemos desarrollado en los puntos anteriores: 


public class app 


public static void mainíString[l args) 
( 
System.out.println("iHola desde Java!"); 
1 
1 


Java admite tres tipos de comentarios, dos de los cuales son de C++. 


Puede poner cualquier comentario de cualquier longitud con los caracteres 
"I*M y "si 


/* Esta aplicación visualiza ";Hola desde Java!" */ 
public class app 
I 

public static void main(String[] args) 

{ 

System.out.println("iHola desde Java!"); 

1 

1 


El compilador de Java ignorará todo el texto que esté entre "/*" y "*/". 


Puede dividir los comentarios que ponga entre estos indicadores en varias 
líneas: 


/* Esta aplicación visualiza "iHola desde JavalR 
Creado por: 0. Whiz, 1/1/00 *) 

public class app 

{ 


public static void main (String[] args) 


( 
System.out.println("iHola desde Java!"); 


De hecho, en muchos entoinos corporativos, se espera que se use una 
cabecera de comentario estándar, creado con "/*" y "*/" para todo código 
nuevo. Sería algo así como: 


y Esta aplicación visualiza ";¡Holadesde Java!" 


* 


Autor: G.Whiz 


“mportaciones Ninguna 


* Parámetros: Argumentos de la línea de comandos i 
* Retorno: Ninguno y 
* , 

Supuestos: Ninguno e 
* Fecha de creación: 1/1/00 * 
* Última actualización: 1/1/01 3 


public class app 
{ 


public static void rnain (String[] args) 


{ 


System.out.println('iH0la desde Java!'!; 
1 
1 


Java también soporta una línea de comentario utilizando la doble barra, 
"11".El compilador de Java ignorará toda la línea después de la doble barra, 
por lo que puede crear líneas enteras de comentarios o añadir un comentario a 
una sola línea: 


/* Esta aplicación visualiza "jHola desde Java!" */ 
public class app //Crear la clase app 
( 


//Crear main( ), punto de entrada a la aplicación. 
public static void main(String[l args) 


{ 


// Visualizar el mensaje con 
System.out.println("iHola desde Java! "); 


Finalmente, Java también soporta un comentario que se inicia con "/**" y 
que termina con "*/". Este comentario está diseñado para usarse con la 
herramienta javadoc, que permite crear documentación casi automáticamente. 
Echaremos un vistazo a esto en el capítulo 21. A continuación hay un ejem- 
plo para el uso de "/**" y "*/": 


/** Esta aplicación visualiza "¡Hola desde Javan1l */ 
public class app 


{ 


public static void main(String[] args) 


( 
System.out.println("iH0la desde Java!"); 
1 


Comentar el código es de gran importancia en entornos de grupo donde se 
comparten los códigos delos archivos fuente. Además es muy cómodo si otra 
persona va a retomar el proyecto en el que ha estado trabajando usted. 


Conocimientos básicos: importando paquetes 
y clases Java 


"Hmm", dice el programador novato, "tengo un problema. El coordinador 
del equipo de diseño me dijo que usara la clase Date para visualizar la fecha 
actual en mi aplicación, pero Java parece no entender la clase Date, me da un 
error cada vez que intento usarlo". "Eso se debe a que la clase Date forma 
parte del paquete de utilidades de Java y tiene que importar ese paquete antes 
de que pueda utilizarlo". "¡Importarlo?", pregunta el programador. 

Las clases que Sun ha creado están almacenadas en librerías de clases 
llamadas "paquetes”. Para que una clase de un paquete esté disponible en su 
código, tiene que importar el paquete, lo que quiere decir que el compilador 
localizará ese paquete para esas clases. Además puede importar clases indivi- 
duales que no son parte de un paquete. Por defecto, sólo las sentencias 
básicas de Java están disponibles en una aplicación, las del paquete java.lang. 
El compilador automáticamente importa el paquete java.lang, pero para usar 
el resto de las clases que vienen con Java tendrá que hacer la importación con 
la instrucción import. Aquí se muestra cómo utilizar esa sentencia: 


import [paquetel[.paquete2... ].]-(nombrede clase[*); 


Observe que se pone un punto ('.') entre el paquete y los nombres de clase 
para separarlos. Los paquetes Java estándares están almacenados en un gran 
paquete llamado java, por lo que el paquete de utilidades se llama realmente 
java.util (hay otros grandes paquetes disponibles; por ejemplo, el paquete 
swing está almacenado en el paquete java). Puede referirse a la clase Date en 
java.util como java.util.Date. A continuación se indica cómo importar esa 
clase en un programa: 


import java.util.Date; 
public class app 
( 


Observe que si va a usar las sentencias import para importar clases en un 
programa, éstas deberían estar en la parte de arriba del código. Así, podemos 
utilizar la clase Date, como se indica a continuación (observe que estamos 
creando un objeto de la clase Date usado el operador Java new, de la que 
aprenderemos más en el capítulo 4): 


import java.util.Date; 


public class app 
I 


public static void main(String[] args) 


“«=st-=.out.println(-Hoy + nrr Date( ))j 
1 
> 


Cuando ejecute esta aplicación, verá la fecha del día: 


c:>java app 
HOY = Lunes 2 Agosto 12:15:13 EDT 2000 


Como puede ver estudiando la forma general de la sentencia previa import, 
hay también una técnica taquigráfica que carga todas las clases de un paque- 
te; se puede usar un asterisco ('*') para utilizar todas las clases de un paquete 
específico. A continuación se indica cómo se podría hacer si quisiera impor- 
tar todas las clases del paquete java.util de una vez: 


import java.util."s 
public class app 
{ 
public static void main (String[] args) 
{ 
System.out.println("Hoy = " + new Date ()); 
1 


Esto está bien si se quiere importar las clases proporcionadas por Sun, ya 
que Java sabe donde buscar las clases con las que fue instalado. Pero ¿qué 
pasa si quiere importar sus propias clases u otras proporcionadas por un tercero? 

He aquí hay un ejemplo. Supongamos que tiene una clase llamada printer 
en un archivo llamado printer.java, y esa clase tiene un método, llamado print: 

public class printer 

I 

public void print( ) 
c 
System. -ut.println (--Holdesde Javaln); 
1 
> 

Podría querer utilizar el método print en otras clases, como en este caso, 
donde estamos creando un nuevo objeto de la clase printer usando el operador 
new y usando el método printer de ese objeto en una aplicación llamada app: 


public class app 


L 
public static void main(String[l args) 


( 


(new printer( )).print( )5 
1 


Para ello, puede importar la clase printer de esta forma (observe que puede 
además poner el código de la clase prínter en el mismo archivo que la clase 
app, en cuyo caso no tendría que importar la clase printer): 


import printer: 
public class app 


public static void main (String[l args) 


{ 


(new printer ()) .print(); 
1 
1 


Esto funciona como debería. Felicidades, acaba de importar una clase en 
su programa. 

Esta técnica es buena si prínter.class está en el mismo directorio en el que 
se está compilando esta aplicación, ya que el compilador Java buscará el 
directorio actual por defecto. Sin embargo, supongamos que quiere almace- 
nar todas sus clases en un directorio llamado c:\clases. ¿Cómo encontrará el 
compilador printer.class allí? Para contestar a esa pregunta, veamos el si- 
guiente punto CLASSPATH. 


Conocimientos básicos: buscar clases Java con 
CLASSPATH 


"Ese jorobado Johnson", dice el programador novato. "Me dio un archivo 
de clases nuevo, johnson.class, para trabajar con él, y se suponía que resolve- 
ría mis problemas con esa hoja de cálculo. Pero Java dice que no puede 
encontrar johnson.class". "¿Dónde tiene ese archivo?", le pregunta. "En un 
directorio especial que creé ;ara ello", dice el PN, "llamado jorobadojohnson". 
"Esees el problema", le dice. "Tiene que incluir el directorio jorobadojohnson 
en su ruta de acceso a clases”. 

Por defecto, Java podrá encontrar sus clases de arranque (con las que 
viene), extensiones de clases (esas que usan el framework de extensiones 
Java; ver en este mismo capítulo) y clases en el directorio actual (es decir, 
donde está compilando su programa). Las clases pueden almacenarse en 


archivos con extensión ".classW'.jarW ".zipWava puede localizar todo este 
tipo de archivos. 

Pero ¿qué ocurre si quiere hacer una búsqueda de clases en otro directorio 
o en un archivo con extensión ".jarWuministradas por un tercero? Puede 
hacerse con la variable de entorno CLASSPATH, ya que Java usa esta varia- 
ble para determinar dónde quiera buscar las clases. 

Veamos un ejemplo que introduje en el punto anterior. Digamos que tiene 
una clase llamada printer en un archivo llamado printer.java, y esa clase tiene 
un método, llamado print: 


public class printer 


I 
public void print ( ) 


{ 
System. ~ut .println (~iHoladesde Java! "); 


1 
> 


Ahora supongamos, como en el punto anterior, que quiere usar el método 
print de otras clases, como en este caso, donde creamos un nuevo objeto de la 
clase printer usando el operador new y usando el método print de ese objeto 
en una aplicación llamada app: 


import printer; 


public class app 
{ 


public static void main (String[] args) 


{ 


(newprinter( )) .print( ): 
1 


Esto funciona si printer.class está en el mismo directorio en el que se está 
compilando esta aplicación, porque el compilador de Java buscará el directo- 
rio actual por defecto. Pero supongamos que quiera almacenar todas sus 
clases en un directorio llamado c:\clases. ¿Cómo buscará el compilador Java 
printer.class ahí? 

Para que el compilador Java busque en c:\clases, puede fijar la variable de 
entorno CLASSPATH para que incluya ese directorio. Por defecto, no hay 
ninguna ruta de acceso ni directorios en CLASSPATH, pero puede añadir a 
CLASSPATH una lista con separaciones por punto y coma (';'), como se 
indica a continuación para Windows (observe que es importante no dejar 
espacios entre los signos de igual): 


En Windows NT, puede seguir estos pasos para fijar la variable de entorno 
CLASSPATH: 


1. Abrir el menú Inicio y abrir el Panel de Control de la opción Configura- 
ción. Hacer doble clic sobre Panel de Control para abrirlo. 


2. En el cuadro de diálogo Propiedades del Sistema, hacer clic sobre la 
pestaña Entorno. 


3. Hacer clic sobre la variable CLASSPATH, haciendo que se vea el valor 
actual de CLASSPATH al final del cuadro de diálogo. 


4. Añadir la ruta de acceso que quiera a CLASSPATH y hacer clic sobre 
OK para cerrar el cuadro de diálogo de Propiedades del Sistema. 


También puede saber el valor actual de CLASSPATH usando el comando 
SET: 


THPEC : \WINDOME\ TEMP 
PAONPT=" L0G 
tdir<C: (WINDOME 

MINDOWRS COMMAND. COM 
FA WIADOAE E: 41 20E1,2.21BIH 
iadlr el: IIADONE 
CLASIPATHEC : VOLASES 0: NECLA SES 


Ahora el compilador de Java (y otras herramientas Java como la utilidad 
java) tendrá suficiente información para buscar en c:\clases y c:inewclasses 
automáticamente. Esto significa que este código funcionará si printer.class 
está en ciiclases, ya que ese directorio está en CLASSPATH: 


import printer; 


public class app 
I 
public static void main(String[] args) 
I 
(new printerO) .printo; 
1 
1 


Puede añadir una nueva ruta de acceso en CLASSPATH a la que ya existe, 
como sigue: 


SET CLASGSPATH "estelar; e: hnic lanten: VIOLADA PATAS 


Observe que también puede buscar archivos con extensión ".jarUy ".zipU 
para las clases: 


SET CLASSPATH=sérver.Jáar;clagaós, ¿lp WLASSPATHY 


En los orígenes, CLASSPATH produjo dolor de cabeza a los programado- 
res de Java ya que ninguna clase era considerada clase de arranque, lo que 
significaba que había que fijar y entender CLASSPATH antes de que se 
pudiera usar Java. Esto se ha arreglado con el concepto de clases de arranque, 
que son clases que vienen con Java (y son localizadas automáticamente). Sin 
embargo, si quiere usar paquetes no estándares y almacenar sus propias 
clases en otros directorios, es importante saber cómo se fija CLASSPATH. 


Crear applets 


El gran jefe se está impacientando. "¿Qué es todo esto de las aplicaciones 
que visualizan "¡Hola desde Java!" en la ventana consola? Queremos usar 
Java para crear applets que se puedan utilizar en los navegadores Web". "De 
acuerdo", le dice, "deme un minuto". 

En los capítulos que siguen, echaremos un vistazo a la sintaxis de Java, 
que sería un duro camino si lo primero que se quisiera hacer fuera escribir 
applets en primer lugar. Lo que es más, sería intolerable si no iniciáramos un 
libro de un lenguaje tan visual como Java con al menos una applet. En este 
punto, cubriré el proceso de crear una applet Java. El saber crear una applet 
básica le ayudará a probar, visualmente, la sintaxis de los siguientes capítu- 
los. Las applets se introducirán formalmente en el capítulo 6; por lo tanto, 
considere esto como un aperitivo. 

Las applets estándar están construidas en la clase Applet, que está en el 
paquete java.applet. Sin embargo, comenzaremos importando esa clase en un 
nuevo archivo de código fuente Java, que llamaremos applet.java: 


import java.applet.Applet; 


La clase java.applet.Applet es la clase que forma la base para las applets 
estándar, y puede derivar sus propias clases de applets de esta clase usando la 
palabra clave extends: 


import java.applet.Applet; 


public class applet extends Applet 
{ 


Es hora de añadir código a esta nueva applet. Las applets no tienen un 
método main como las aplicaciones; de hecho, esa es la diferencia principal 


entre applets y aplicaciones. Por lo tanto, ¿cómo se puede visualizar texto 
directamente en una applet? 

El trazado actual de una applet está contenido en su método paint, que la 
máquina virtual de Java llama cuando es hora de visualizar laapplet. La clase 
java.applet. Applet tiene su propio método paint, pero podemos sobrescribir 
el método definiendo su propio métodopaint, como sigue (ver capítulos 4 y 5 
para más detalles de la sobrescritura): 


import jJava.applet.Applet; 
import jJava.awt.*; 


public class applet extends Applet 


public void paint (Graphics g) 
( 


Este método paint es realmente una parte de Java Abstract Windows 
Toolkit (AWT), que verá con gran detalle en este libro, por lo que hemos 
importado las clases AWT con la instrucción import.java.awt.*. Verá cómo 
el siguiente método paint se pasa a un objeto Java de la clase Graphics (este 
objeto se llama g en el código). Puede usar el método drawstring de este 
objeto para dibujar el texto. 

En este caso, dibujaremos el texto "¡Hola desde Java!" en las coordenadas 
(60,100) en la applet; las coordenadas se miden en pixels desde la parte 
superior izquierda de la applet, por lo que esta posición está a 60 pixels del 
borde izquierdo de la applet y a 100 pixels del el superior. Este es el códi- 
go: 


import Java.applet.Applet; 
import Java.awt.?* ; 


public class applet extends Applet 


( 
public void paint (Graphics g) 


( 
g.drawString("iHola desde Javaln, 60, 100); 


Eso es todo, ahora puede compilar applet-javapara obtener applet.class. 
Hay un paso más: crear una página Web para visualizar en ella la applet. 
Veremos esto a continuación. 
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Ejecutar applets 


"De acuerdo", dice el gran jefe, "ha creado una applet. ¿Por qué no lo veo 
en una página Web?" "Veámoslo," dice. "Creo...”. 

Para visualizar una applet, puede usar una página Web con la etiqueta 
<APPLET>de HTML (Hypertext Markup Language). De hecho, se puede 
almacenar el HTML necesario en un archivo de código fuente de applets, 
como podrá ver en el capítulo' 6; además lo aprenderá todo sobre la etiqueta 
<APPLET>en ese capítulo. Por ahora, aquí hay una página Web, applet.htm1, 
que visualizará la applet desarrollada en el punto anterior: 


<WTHL > 

<HEAD> 

<TITLE>APPLET<TITLE+ 

<NEAD> 

«BODY> 

<HR> 

CENTER? 

CAFFLET 
CODE-applet.clasa 
WIDTH=200 
HEIGHT=200 > 

APPLET 

<; CENTER 

< HA> 

</BODT> 

- HTHL> 


Puede abrir esta applet en una página Web con un navegador Web, como 
se ve en la figura 1.6, donde la applet se ha abierto con Microsoft Internet 
Explorer. 


E S r LL. z 
Figura 1.6. Una applet funcionando con Internet Explorer. 


Además puede usar el visualizador de applets de Sun, que viene con Java, 
para abrir applet.htm1l, de la siguiente forma: 


EC14>app letviewer epplet.html 


La figura 1.7 muestra la applet con el visualizador de applets de Sun. 


ARE 


[EN ugt Wise appi 


rola desde a! 


Appa anig 


Figura 1.7. Una applet funcionando en el visualizador de applets de Sun. 


Crear aplicaciones ventana 


El gran jefe está impresionado con su nueva applet y pregunta, "¿Puede 
también hacer que una aplicación visualice ventanas?" "Por supuesto", le 
dice. "Vayamos a ello". 

Lo aprenderá todo sobre la creación de aplicaciones ventana en el capítulo 
6, pero tomaremos un primer contacto aquí. Crear una aplicación ventana es 
parecido a la creación de una applet, con la excepción de que tiene que tener 
un método main, y que usted es el responsable de crear la ventana. Con el fin 
crear la ventana para la aplicación, derivaremos una nueva clase de la clase 
AWT Frame y añadiremos el mismo código del método paint que se utilizó 
en la applet del apartado anterior: 


import java.awt.* ; 


class AppFrame extends Frame 
( 
public void paintiGraphics g) 
{ 
g.drawString("iHola desde Javal", 60, 100); 
1 


Ahora crearemos la clase aplicación, que llamaremos app. Esta es la clase 
que tendrá un método rnain, y en ese método, usaremos el operador new para 
crear un nuevo objeto de la clase AppFrame al que se le dará un tamaño en 
pixels y se mostrará en la pantalla: 


import java.awt.*; 
import java.awt.event.*; 


class AppFrame extends Frame 


public void paint (Graphics g) 
( 
g.drawString("iHola desde Java!", 60, 100); 
1 
1 


public class app 
{ 


public static void main(String [l args) 
{ 
AppPrame f = new AppFrame( ); 
E.aestSlzs(200, 20017 


E.addHindowllatenesr (new WindoeAdapteri 1 [publio vola 
windorCloslsg(WindowErent e) (Sytem.exitií011 1110 


E aho da 


Ahora que la nueva aplicación ventana está preparada, ¿cómo se ejecuta? 
Echemos un vistazo al siguiente punto. 


Ejecutar aplicaciones ventana 


Como con las aplicaciones consola, para ejecutar una aplicación ventana, 
puede usar las utilidades java o javaw: 


java app 
javaw app 


La utilidad java lanza la aplicación y hace que la ventana consola espere 
hasta que la aplicación sea desechada, mientras que la utilidad javaw lanza la 
aplicación y no espera a que la aplicación sea desechada. La ejecución de la 
aplicación aparece en la figura 1.8. 

Esto es todo; ahora ejecutaremos aplicaciones ventana Java. 


Figura 1.8. Una aplicación ventana. 


Diseño de programas Java 


El diseño de la cabecera del programa ya está hecho, y su nueva oficina 
funciona. Pero cuando se sienta usted allí, mirando fijamente la esquina de la 
ventana y golpeando su nueva mesa, se pregunta si es capaz de conservar su 
nueva posición. 

El diseño de los programas en Java no es tarea fácil. Un buen diseño de 
programación involucra muchos aspectos, y echaremos un vistazo a algunos 
de ellos en este capítulo, antes de empezar a excavar en la sintaxis de Java. 

De hecho, uno de los aspectos más importantes de la creación de una 
nueva aplicación es diseñarla. Si no se selecciona bien puede que sea necesa- 
rio hacer muchas revisiones del producto. Muchos libros se dedican al diseño 
de programas. Microsoft, que debería saber algo de ello, divide el proceso en 
cuatro áreas: 


e Rendimiento. Responsabilidad y optimización global de la velocidad y 
USO de recursos. 


e Mantenimiento. Capacidad de la aplicación para ser mantenida fácil- 
mente. 


e Extensibilidad. Capacidad de la aplicación para ser extendida de formas 
bien definidas. 


E 


e Disponibilidad. Robustez de la implementación de la aplicación y 
disponibilidad para su uso. 


Veamos rápidamente estas cuatro áreas. 


Rendimiento 


El rendimiento es un tema de diseño que es duro de argumentar. Si los 
usuarios no consiguen lo que quieren con su aplicación, esto se convierte 
claramente un problema. En general, el rendimiento depende de las necesida- 
des de los usuarios. Para algunas personas, la velocidad es esencial; para 
otros, la robustez o el uso eficiente de los recursos es lo que están buscando. 
Globalmente, el rendimiento de una aplicación es una indicación de lo bien 
que responde a las necesidades de los usuarios. He aquí algunos aspectos 
generales de rendimiento que debería considerar cuando escriba programas 
Java: 


e eficiencia del algoritmo 

e velocidad de CPU 

e diseño y normalización eficiente de base de datos 
e limitación de accesos externos 

e velocidad de la red 

e temas de seguridad 


e Uso de recursos 


e velocidad de acceso a la Web 


A lo largo del libro trataremos más temas específicos de rendimiento. 


Mantenimiento 


El mantenimiento es la medida de lo fácilmente que puede adaptarse su 
aplicación a necesidades futuras. Este asunto se deriva de buenas prácticas de 
programación, de las que hablaré a lo largo del libro. Buena parte de esto es 
de sentido común, simplemente tener en mente las necesidades de codifica- 
ción futura al escribir el código. Algunos puntos de la "programación ópti- 
ma” son los siguientes: 


e Evitar el uso de bucles y condicionales anidados. 


e Evitar el paso de variables globales a procedimientos 


e Ser modular cuando se escribe el código. 

e Dividir el código en paquetes. 

e Documentar los cambios de programa. 

e Dar a cada procedimiento un único propósito. 


e Asegurarse de que la aplicación puede extenderse sin problemas a más 
tareas y mayor número de usuarios. 


e Planificar la reutilización de código. 

e Programar de forma defensiva. 

e Uso de procedimientos para el acceso a datos sensibles. 
e Uso de comentarios. 


e Uso de nombres de variables consistentes. 


e Uso de constantes en lugar de números "mágicos". 


Extensibilidad 


La extensibilidad es la capacidad de la aplicación para extenderse de una 
forma bien definida y relativamente fácil. Generalmente, supone una preocu- 
pación en las aplicaciones grandes y, con frecuencia, involucra a toda una 
interfaz especialmente diseñada para la extensión de módulos. De hecho, 
Java, en sí mismo, está diseñado para ser extendido, usando el framework de 
extensiones Java. 


Disponibilidad 


La disponibilidad es medir del tiempo que la aplicación puede utilizarse, 
en comparación con el tiempo que los usuarios quieren utilizarla. Esto lo 
incluye todo, desde que no se quede congelada cuando se ejecuta una tarea 
larga (al menos, dar al usuario el estado de la operación), hasta trabajar con 
técnicas y métodos que no se cuelguen, hacer backups de datos críticos y 
planificar el uso alternativo de'recursos, si es posible, cuando el acceso al 
recurso deseado esté bloqueado. 

Globalmente el proceso de diseño es de los que más tiempo requiere. De 
hecho, todo el ciclo de desarrollo es tema de muchos estudios, puede resultar 
sorprendente saber que algunos de ellos consideran que el diseño es, al 
menos, el quince por ciento del proyecto total cuando se prueba un campo y 
se añaden planificación, diseño y pruebas de interfaz de usuario. 


No entraremos en más detalle sobre el ciclo de desarrollo de software, 
pero los programadores no deberían cambiar los pasos críticos del diseño en 
proyectos serios, ya que pueden dar más problemas en una ejecución larga 
que el tiempo que ahorran en una ejecución corta. 


Distribución del programa Java 


"Bien", dice el programador novato, "he terminado mi programa Java, y 
estoy preparado para venderlo”. "Ah, jsí?" pregunta. "Revisaremos primero 
los temas de licencia". 

Para que los usuarios ejecuten sus programas, necesitarán tener un entorno 
de ejecución Java en sus sistemas. El JDK de Java 2 contiene un entorno de 
ejecución, por lo que los usuarios podrían usar su programa si lo tuvieran 
instalado. Sin embargo, observe que la mayoría de los usuarios no tendrán 
todo el JDK Java 2 instalado, por lo que la mejor selección para los usuarios 
será el entorno de ejecución de Java 2 (JRE). Aquí es donde la distribución de 
JRE en lugar de JDK ocupa un lugar destacado: 


e El entorno de ejecución de Java es redistribuible, y el JDK de Java 2 no, 
lo que viene a decir que la licencia de JRE le permite empaquetarlo con 
su software. Mediante la distribución de JRE de su aplicación, puede 
asegurarse de que sus usuarios tendrán la versión correcta del entorno 
de ejecución de su software. 


+ El JRE es más pequeño que el JDK. El JRE contiene todo lo que los 
usuarios necesitan para ejecutar su software, pero no incluye las herra- 
mientas de desarrollo y las aplicaciones que forman parte del JDK. 
Dado que el JRE es pequeño, es más fácil empaquetarlo con su software 
en vez de que los usuarios lo descarguen del sitio Web de software Java. 


e En Windows, el instalador JRE instala automáticamente java y javaw 
en la ruta de acceso del sistema operativo, lo que significa que no tiene 
que preocuparse de encontrar los lanzadores para iniciar la aplicación 
(es decir, no tiene que dar instrucciones a los usuarios para que esta- 
blezcan las rutas de acceso en sus sistemas). 


Puede encontrar más información sobre el entorno de ejecución de Java 2 
en http://java.sun.com/products/jdk/l.2/runtime.html. 


m Variables, 
arrays y cadenas 


Este capítulo inicia nuestra discusión sobre la sintaxis de Java, y se verá 
gran parte de ella. Aquí, vamos a tratar sobre cómo se almacenan y recuperan, 
en Java, los datos de variables,arrays y cadenas. El trabajo con datos es parte 
fundamental de cualquier programa, y la información contenida en este capí- 
tulo es esencial para cualquier programador de Java. Aunque ya programe en 
Java, eche un vistazo al material de este capítulo, porque hay mucho que ver. 


Variables 


Las variables pueden ser de diferentes tipos y actúan como gestores de 
memoria de los datos. Los diferentes tipos tienen que ver con el formato de 
los datos que se almacenan en ellas, así como con la memoria que es necesa- 
ria para gestionar ese dato. Por ejemplo, la variable de tipo entero, int, es de 
4 bytes (o 32 bits) y se utiliza para almacenar valores enteros. Esto hace que 
un dato de tipo int pueda tomar un rango de valores que va desde 
-2.147.483.648 hasta 2.147.483.647. En Java, hay bastantes tipos de varia- 
bles, por ejemplo, enteros, coma flotante y caracteres, que veremos en este 
capítulo. 


Antes de usar una variable en Java, debe declararla, especificando su tipo. 
A continuación se indica cómo se declaran las variables en Java: 


tipo nombre [ = valor] [, nombre [ = valor]... ] 


Ahora, podemos ver cómo se declara una variable de tipo int, es decir que 
contiene un entero (la variable se llama days): 


public class app 
( 


public static void main(String[] args) 


{ 
int days; 


Este código aloca 32 bits de memoria y etiqueta esa ubicación, de forma 
que el compilador entiende la variable days y en el código puede haber 
referencias a ese nombre. A continuación, se indica cómo se almacena un 
valor numérico de 365 en days, utilizando el operador de asignación de Java 


(>): 


public class app 
( 


public static void main (String[] args) 


1 
int days; 
days = 365; 


En este caso, el valor 365 es una constante entera, es decir, un valor 
constante que se sitúa directamente en el código. A lo largo de este capítulo, 
veremos los tipos de constantes que Java permite. Para comprobar que days 
contiene el valor 365, lo visualizamos por pantalla: 

public class app 

I 


public static void mainíString[] args) 
1 

int days; 

days = 365; 


System. ont.pristine j Hüsaro de días = * + daya}; 


Este es el resultado del código: 


C:i>java aPP 

Número de días = 365 

Como puede ver, hemos creado una variable en la que se han almacenado 
datos y se ha obtenido ese dato para visualizarlo en pantalla. Así funciona. 

Hay un convenio que permite inicializar una variable en el momento de 
declararla. A continuación, se puede ver comodays se declara e inicializa con 
el valor 365 en un único pasoi 


public class app 
( 


public static void main (String[l args) 


{ 
int days = 365; 


~ystem.out .println ("Númerode días = " + days); 
4 
1 
El tipo int es una de las clases de variables que se pueden usar. Estas son 
todas las posibilidades: 


e Enteros: Estos tipos son byte, short, int y long, que guardan el signo y el 
valor. 


e Números en coma flotante: Estos tipos sonfloat y double, que almace- 
nan números en coma flotante con signo. 


e Caracteres: Este es el tipo char, que guarda las representaciones de los 
caracteres, tanto letras como números. 


e Booleano: Este tipo está diseñado para guardar sólo dos valores: verda- 
dero (true)o falso (false). 


Veremos todos estos tipos con más detalle más adelante, incluyendo el 
rango de valores que puede tomar cada uno. Todos ellos forman lo que en 
Java se conoce como tipos de datos sencillos. Cada uno de estos tipos repre- 
senta un valor de datos sencillos, no uno compuesto (en oposición a unarray, 
que también se tratará en este capítulo). Es posible almacenar un dato en una 
variable de cualquier tipo y ese dato debe estar dentro del rango permitido 
para ese tipo. 


Tipos de datos 


Java pone mucho énfasis en sus tipos de datos. Es un lenguaje que insiste 
en que las variables sencillas que se declaran y se utilizan deben correspon- 
derse con la lista establecida. 


Arrays 


Todas las variables sencillas deben tener un tipo (y de hecho, toda expre- 
sión, toda combinación de términos que Java puede evaluar para obtener un 
resultado, también tiene un tipo). Además, Java es muy particular para man- 
tener la integridad de esos tipos, especialmente si intenta asignar un valor de 
un tipo a una variable de otro tipo. Java es más insistente en cuanto al tipode 
datos que un lenguaje como C++; en C++, por ejemplo, se puede asignar un 
número en coma flotante a un entero y C++ gestionará la conversión de tipos, 
pero eso no se puede hacer en Java. Sin embargo, en Java, puede haber 
conversión entre ciertos tipos de datos, por ejemplo, entre tipos de enteros, 
como veremos en este capítulo. 


Hasta aquí, hemos revisado lo que Java hace con los tipos de datos senci- 
llos y variables; ya es hora de echar un vistazo al almacenamiento de datos, lo 
que se denomina arrays. 


Los tipos sencillos son buenos para almacenar datos simples, pero con 
frecuencia, los datos son más complejos. Supongamos, por ejemplo, que 
quiere crear un nuevo banco, el Banco de Programación Java, y necesita 
obtener la cantidad de dinero de cada cuenta, utilizando como índice el 
número de cuenta. En este caso, es mejor trabajar con datos compuestos, que 
son proporcionados por los arrays. 

Utilizando un array, podrá agrupar tipos de datos sencillos en estructuras 
más complejas y hacer referencia a esa nueva estructura por su nombre. Lo 
que es más importante: mediante un índice numérico, podrá hacer referencia 
a los datos individuales almacenados en el array. Eso es importante, porque 
los ordenadores se destacan por ejecutar millones de operaciones muy rápida- 
mente, por lo tanto si se puede hacer referencia a los datos con un índice 
numérico, se puede trabajar muy rápido con un conjunto de datos, simplemente 
incrementando el índice del array para así, acceder a todos sus elementos. 

Aquí tenemos un ejemplo. En este caso, empezaré con 100 nuevas cuentas 
en el Banco de Programación de Java y cada una tendrá su propia entrada en 


un array llamado accounts[]. Los corchetes indican que es un array, y entre 
ellos se sitúa el índice del elemento del array al que se quiere acceder. A 
continuación se puede ver cómo he creado el array accounts[], haciendo que 
cada elemento sea de tipo doble para obtener mucha precisión. Primero, 
declaro el array y luego lo creo con el operador new, que es el que Java 
utiliza para ubicar memoria: 


public class app 
I 


public static void main (String[l args) 


I 


double accounts[ 1; 


accounts = new double [1001 ; 


Ahora que he creado un array con 100 elementos, puedo hacer referencia 
a ellos numéricamente, como se indica a continuación (observe que estoy 
almacenando $43.95 en la cuenta 3 y visualizando esa cantidad): 


public class app 
{ 


public static void main(String[l args) 


I 


double accounts [! ; 

accounts = new double[1001; 

accounts [3] = 43.957 

System.out.println("La cuenta 3 tiene $" = + accounts [31): 
1 
Este es el resultado del programa: 


C:\>java app 
La cuenta 3 tiene $43.95 


Como puede ver, ahora puede referirse a los elementos del array utilizan- 
do un Índice numérico, que los organiza fácilmente. En Java, el elemento más 
bajo declarado de esta forma es el 0, por lo que la sentencia accounts = new 
double[100] crea un arraycuyo primer elemento es accounts[O] y el último es 
accounts[99]. 

Se pueden combinar los pasos de declaración y creación en uno solo: 


public class app 
I 
public static void main (String[l args) 
I 
double accountsl 1 = new double[1001; 


accounts[31 = 43.95; 


System.out.println("La cuenta 3 tiene $" + accounts[31); 
1 


Además se puede inicializar un array con valores cuando se declara, 
encerrando entre llaves la lista de valores. Por ejemplo, este código crea 
cuatro cuentas y guarda el valor 43.95 en accounts[3]: 


public class app 
( 


public static void main (String[] args) 


( 
double accounts[ 1 = (0, O, 0, 43.95); 


accounts[3] = 43.95; 


System.out.println("La cuenta 3 tiene $" + accounts[31);5 


1 


Esto hará que algunos clientes del Banco de Programación de Java no 
estén contentos, por supuesto; además de una cuenta corriente quieren una 
cuenta de ahorro. ¿Cómo gestionaremos esto y mantendremos todo indexado 
por número de cuenta? 

El array accounts[] es un array unidimensional, también llamado vector, 
es decir, es una lista de números que pueden ser indexados por otro número. 
Sin embargo, en Java, los arrays pueden tener muchas dimensiones, lo que 
significa que se pueden tener muchos índices. En el siguiente ejemplo, exten- 
deré accounts[] a unarray de dos dimensiones, accounts[][], para gestionar la 
cuenta de ahorro y la cuenta corriente. El primer índice de accounts[][] será O 
para la cuenta de ahorro y 1 para la cuenta corriente, y el segundo índice será 
el número de la cuenta como antes. Así sería el código: 


public class app 


public static void main (String[] args) 


{ 
double accounts[ 1[ 1 = new double [2] [1001; 


accounts[01[31 = 43.95; 
accounts [1] 131 = 2385489382.06; 


System. ~ut .println (~-æuenta de ahorro 3 tiene $" + account [0] 131; 


System. ~ut .printin (~Læuenta corriente 3 tiene $" + accounts[11 131; 
1 
1 


Ahora que accounts[][] es un array de dos dimensiones, la referencia a 
cada elemento se hace utilizando dos índices, por ejemplo, el saldo de la 


cuenta de ahorro 3 es accounts[0][3] y el saldo de la cuenta corriente es 
accounts[1][3]. Estos son los resultados al ejecutar la aplicación: 


C:l>java app 
La cuenta de ahorro 3 tiene $43.95 
La cuenta corriente 3 tiene $2.3854893820639 


Observe que he dado a la cuenta corriente 3 un saldo de $2,385,489,382.06 
(ilusión) y que Java ha visualizado 2.38548938206 x lo9. 


Cadenas 


Quizás se haya dado cuenta de que, en los ejemplos anteriores, he usado 
el operador + para crear el texto que se va a visualizar: 


public class app 

{ 
public static void main (String[l args) 
L 


double accounts[1[!l = new double [2] [1001 ; 
accounte[0] [3] = 43.95; 
acecunta[1]13] = 23585409302, 06; 


System.out.println("Lacuentade ahorro 3 tiene 5" + accounts[01 131; 
Systam.out.println("La cuentacorriente 3tine $" + accounts [11[31; 


1 


Esto se debe a que las propias clases de Java (la clase String), soportan las 
cadenas de texto y se puede considerar la clase String como la definición de 
un nuevo tipo de datos. Por ejemplo, a continuación se puede ver cómo se 
crea una cadena llamada greeting que guarda el texto "¡Hola desde Java!": 


public class app 
( 


public static void main(String[l args) 


I 


String greeting = ";Hola desde Java!"; 


Ahora, se puede tratar esta cadena de igual forma que los otros tipos de 
variables, incluyendo su visualización: 


public class app 


( 
public static void main(String[] args) 


( 
String greeting = "¡Hola desde Java!"; 


Eyotem.out .printlinigreatiag!; 


Este es el resultado de la aplicación: 


C:X>java app 
¡Hola desde Java! 


Aunque las cadenas no son uno de los tipos sencillos de Java, tienen un 
espacio en este capítulo, ya que la mayoría de los programadores los tratan 
como cualquier otro tipo de datos. De hecho, muchos programadores argu- 
mentarían que las cadenas deberían ser un tipo de datos sencillos en Java, 
como lo son en otros lenguajes. La razón es que no tienen nada que ver con la 
línea de Java, que extiende el lenguaje C. C no tiene un tipo sencillo de 
cadenas; en C, se gestionan las cadenas como arrays unidimensionales de 
caracteres, lo que es bastante embarazoso. Una de las cosas sobre C++ que 
hacía felices a los programadores era que la mayoría de las implementaciones 
incluían una clase String, que se podía usar igual que cualquier otro tipo de 
datos. Java continúa con este uso, implementando las cadenas como una 
clase, no como un tipo de dato intrínseco, pero la gestión de cadenas es tan 
fundamental para la programación, que tiene sentido revisar las cadenas en 
este capítulo. 

Hay dos clases string en Java: String y StringBuffer. Se utiliza la clase 
String para crear cadenas de texto que no se pueden modificar. Como puede 
ver en el código anterior, puede utilizar cadenas como si fuera un tipo senci- 
llo de Java. Echaremos un vistazo al uso de cadenas en este capítulo y en el 
siguiente (uso de operadores + y -). Revisaremos también el uso de operado- 
res en las cadenas. 

Por ahora, es suficiente. Comenzaremos a crear y a usar variables, arrays 
y cadenas. 


¿De qué tipo de datos disponemos? 


"Veamos", dice el gran jefe (GJ), "¿cómo escribiría un programa Java para 
gestionar la deuda de la empresa?" "¿Estamos en deuda?" pregunta. "Sólo un 
poco", responde GJ. "¿Cuánto?" le pregunta. "Aproximadamente 
$2.848.238.493.902,77", dice GJ. "Hmm", dice. "Creo que hay que usar 
números en coma flotante". 

¿Qué tipo de datos sencillos puede usar para crear variables en Java? Los 
encontrará en la tabla 2.1. 

Los tipos de datos sencillos pueden clasificarse por categorías, como se 
hizo al principio de este capítulo: 


e Enteros: estos tipos son byte, short, int y long, que guardan el signo y el 
valor. 


Tabla 2.1. Tipos de variables. 


Tipo de variable Almacenamiento Rango de valores 

en bytes 
boolean 2 Verdadero, Falso | 
byta 1 -128 a 127 | 
char 2 N/A | 
double 8 -1.79769313486232E308 a 


-94065645841 247E-324 para 
valores negativos y 
4.94065645841 247E-324 a 
1.7976931 3486232E308 para 
valores positivos 


float El -3.402823E38 a -1.401298E-45 
para valores negativos y 
1.401298E-45 a 3.402823E38 
para valores positivos 


int 4 -2,147,483,648 a2,147,483,647 
| lona B -4,223,372,036,854,775,808 a 
4.223,372 096, 854,775,807 
short 2 -32,768 a 32,767 


e Números en coma flotante: estos tipos sonfloat y double, que almace- 
nan números en coma flotante con signo. 


e Caracteres: este es el tipo char, que guarda las representaciones de los 
caracteres, tanto letras como números. 


e Booleano: este tipo está diseñado para guardar sólo dos valores: verda- 
dero (true)o falso (false). 


Hasta aquí, una visión general de los tipos de datos sencillos que están 
disponibles. Veamos los siguientes puntos para ver cómo funciona cada uno 
de ellos. 


Creación de literales enteros 


El programador novato aparece y dice, "¿cómo asigno un valor hexadecimal, 
base 16, a una variable en Java?" 

"Tiene que usar un literal hexadecimal, que empieza con los caracteres Ox 
o OX", le responde. 

Un literal es un valor constante que se puede usar directamente en el 
código Java, y hay una serie de reglas para controlarlo. En este capítulo, ya he 
usado literales enteros, que son los que uilizan la mayoría de los programado- 
res. Este es el ejemplo anterior: 


public class app 
1 


public static void main (String[] args) 


{ 
int days = 365; 


System.out .printi1n ("Número de días = + daysl; 
1 
} 


Aquí, estoy asignando un literal entero con un valor de 365 a la variable 
days. Por defecto, los literales enteros son del tipo int. Sin embargo, si se les 
asigna a otros tipos de enteros, como short, Java convierte el tipo de literal 
automáticamente. Por otro lado, los valores long pueden tener más dígitos 
que los int, por lo que Java proporciona una forma explícita de crear constan- 
tes long: se añade una 'L” al final del literal. Este es el ejemplo: 


public class app 
I 
public static void rnain(String[l args) 
{ 
long value; 
value = 1234567890123456789L; 


System.out.println("El valor = " + value); 


Este es el resultado del código: 


c:i>java app 
~l valor = 1234567890123456789 


Además puede crear literales en formato octal empezando con un cero y en 
formato hexadecimal empezando con Cx o OX. Estos son algunos ejemplos: 


public class app 
I 


public static void main(String[] args) 


{ 


int value; 
value = 16; 
System.out.println("16 decimal = + value); 


value = 020; 


System.out.println("20 octal = + value + " en decimal".); 


value = 0x10; 


System.out.println("10 hexadecimal = " + value + " en decimal". ); 


Esto es lo que el programa visualiza: 


C:\>java app 

16 decimal = 16 

20 octal = 16 en decimal. 

10 hexadecimal = 16 en decimal. 


Creación de literales en coma flotante 


El programador novato aparece y dice, "Tengo un problema. Quiero poner 
un número en coma flotante, 1.5, en una variable de coma flotante, pero Java 
insiste en decir "Tipo incompatible para =. Se necesita conversión específica 
para double". ¿Qué ocurre?" "Por defecto", le dice, "los números en coma 
flotanteque se utilizan como literales son de tipo double, no de tipofloat. Se 
pueden cambiar añadiendo una '£'o 'F' al final del literal para convertirlo en 
float o una 'd' o 'D' para pasarlo a double". "¡Ah!",contesta el PN. 


En el código, los literales en coma flotante son de tipo double por defecto, 
como por ejemplo, 3.1415926535, 1.5 y 0.1111111. La notación estándar 
para los literales en coma flotante es un número seguido por una parte 
fraccionaria. Además se puede indicar en potencia de 10 con 'e’ o'E”: 


Esto es lo mismo que 1.345 x 101%ó -9.999E-23, que es lo mismo que 
9.999 x lo-23. 


A continuación, vemos un ejemplo en el que se trata de asignar un literal 
en coma flotante a una variable tipofiroat: 


public class app 
I 


public static void main(String[l args) 
I 


float value; 


value = 1.5f; 


System.out.println("El valor = + value); 
1 


Desafortunadamente, el tipo por defecto de los literales en coma flotante, 
es double, por lo que Java devuelve el siguiente error: 


C: N>javac app. java -deprecation 
app. java:7: Incompatible type for =. Explicit cast needed to convert 
double 
to float. 
value = 1.5; 


A 


1 error 


Esto se puede arreglar explícitamente convirtiendo el literal afiroat, como 
se indica a continuación: 


public class app 
{ 


public static void main(String[] args) 
{ 
float value; 
value = 1.5f; 
System.out.println("El valor = 


+ value); 
1 


Ahora, el código se ejecuta como esperamos: 


C:\>java app 
~l valor = 1.5 


Creación de literales booleanos 


En Java, los valores booleanos sólo pueden ser verdaderos o falsos (no 0 ó 
l u otros valores numéricos como ocurre en otros lenguajes; esto forma parte 
de la insistencia de Java en los tipos de datos). Esto quiere decir que los 
únicos dos literales booleanos que se pueden usar son verdadero y falso. 

A continuación vemos un ejemplo que utiliza verdadero (true)como lite- 
ral booleano: 


public class app 
{ 


public static void main (String[l args) 


( 


boolean value; 
value = true; 
System.out.println("El valor = 


+ value); 
1 
1 


Este es el resultado del programa: 


C:\>java app 
El valor = true 


Creación de literales carácter 


"Hey", dice el programador novato, "¿cómo asigno una letra a una varia- 
ble en Java? Estoy evaluando todos los productos de la empresa y quiero 
asignarles letras". "Puede usar literales de tipo carácter, cada uno de los 
cuales representa un carácter", le responde. "Por cierto, ¿el gran jefe sabe 
esto?" "Todavía no", dice el PN. 

La forma básica de un literal de tipo carácter en Java es un valor que 
corresponde a un carácter del conjunto de caracteres Unicode (para más 
detalles sobre Unicode, ver www.unicode.org). Los literales de tipo carácter 
son números que actúan como índices dentro del conjunto de caracteres 
Unicode, no caracteres actuales. Por ejemplo, el código Unicode para la letra 
'C' es 67. Sin embargo, la siguiente aplicación visualiza una 'C': 


public class app 
( 


public static void main (String[l args) 
i 
char char3; 


cbarl = 67; 


System.out.println("La tercera letra del alfabeto = + char3); 


También, puede referirse al código Unicode para la letra C con un literal 
de tipo carácter encerrado entre comillas simples: 


public class app 

1 
public static void main(String[] args) 
1 


char char3; 


chari = “03 


System.out.printlní"La tercera letra del alfabeto = + Cchar3); 
1 


Además de encerrar los caracteres entre comillas simples, también puede 
encerrar secuencias de escape entre este tipo de comillas para obtener litera- 
les de tipo carácter que no pueden conseguirse tecleando un simple carácter. 
Estas son las secuencias de escape: 


e Y (comilla simple) 

e Y" (comillas dobles) 

e M (barra invertida) 

e W (espacio en blanco) 
e \ddd (carácter octal) 

e \f (avance) 

e \n (nueva línea) 

e \r (retorno de carro) 

e WM (tabulador) 


e \uxxxx (carácter Unicode en hexadecimal) 


Por ejemplo, si quiere que se visualice una doble comilla que aparece en el 
texto, puede utilizar la secuencia de escape \": 


public class app 
1 
public static void main(String[] args) 
I 
«yet-.out.printiní-ílijo, \n;Rolal\"m); 


Este es el resultado del código: 


c:>java aPP 
$1 dijo, "iHola!" 


Creación de literales tipo cadena 


El programador novato regresa con un café. "De acuerdo", dice, "este es el 
problema: quiero usar una sentencia println para sacar varias líneas, ¿puedo 
hacerlo?" "Claro", le dice, "utilice el literal de tipo carácter \n para añadir una 
nueva línea". "~ C Ó ~ Qe gunta PN. 

Esto es un ejemplo de lo que PN quiere hacer. En este caso, visualizaré 
varias líneas de texto utilizando el literal \n para comenzar una nueva línea: 


public class app 
{ 


public static void main(String[] args) 


{ 


System.o-t.println(-Estoes \nun texto\nde varias líneasm.); 
1 
1 


Esta es la salida de la aplicación: 


C:X>java app 
Esto es 

un texto 

de varias líneas 


Como con la mayoría de los lenguajes de programación, se pueden poner 
cadenas entre comillas dobles (al igual que los literales de tipo carácter se 
encierran entre comillas simples). Además se pueden utilizar secuencias de 
escape introducidas en la sección anterior. Observe que el compilador con- 
vierte los literales de tipo cadena en objetos String, no en tipos de datos 
sencillos inherentes (lo que quiere decir que el código como "HolaW .length() 
es perfectamente legal y devuelve la longitud de la cadena "Hola"). 


Declaración de variables de tipo entero 


"Realmente, ahora es cuando estoy programando", dice el programador 
novato, "y necesito almacenar algunos datos enteros. ¿Cómo puedo hacerlo?" 
"Con una variable entera", le dice. "Tome una silla y veámoslo". 

Java utiliza cuatro tipos de enteros, cada uno con su propio número de 
bytes alocados en memoria: byte (un byte), short (dos bytes), int (cuatro 
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bytes) y long (ocho bytes). Para conocer el posible rango de valores que cada 
uno puede tomar, ver el punto "¿Dequé tipos de datos disponemos?", en este 
capítulo. Usar uno u otro depende del rango de datos que se quiera, así como 
de otras consideraciones, como cuánta memoria hay disponible (en caso de 
que se quieran tener muchos enteros). 

Esto es un ejemplo que utiliza todos los tipos enteros, declara un entero de 
cada tipo, asigna a cada tipo un dato y luego visualiza ese dato: 


public class app 


public static void main(String[l1 args) 
{ 

byte bytel; 

short shortl; 

int intl; 

long longl; 

bytel = 1; 

shortl = 100; 

intl = 10000; 

longl = 100000000; 


System.out.println("bytel = » + bytel); 
System.out.println("shortl = " + shortl); 
System.out .println("intl = ' + intl); 


System.out.println("longl = + longl); 


1 

Este es el resultado de la aplicación: 
bytel = 1 

shortl = 100 


intl = 10000 
longl = 100000000 


Declaración de variables de tipo coma flotante 


"Lo siento", dice el programador novato, "pero los enteros no se truncan. 
Estoy tratando de diseñar un conversor de moneda y creía que se podía 
ignorar la parte decimal de cada valor, pero el gran jefe me dijo que todos los 
decimales cuentan. ¿Hay algún otro tipo de datos que pueda utilizar?" "Cla- 
ro", le dice. "Puede usarfloats y doubles". 

Java incluye dos tipos de variables en coma flotante, cada uno con su 
propio número de bytes para alocar en memoria:float (cuatro bytes) y double 
(ocho bytes). Para ver el rango posible de valores que cada tipo puede gestio- 
nar, ver la sección "¿De qué tipo de datos disponemos?", en este capítulo. El 


usar uno u otro depende del rango de los datos que se quiera, así como de 
otras consideraciones, como cuánta memoria hay disponible (en el caso de 
que se quiera tener muchos valores en coma flotante). 

A continuación tiene un ejemplo que declara y usa ambos tipos, float y 
double (observe que explícitamente hago que los literales seanfloat o double, 
por lo que no habrá ningún problema con las conversiones de tipo): 


public class app 
1 


public static void rnain(String[] args) 


{ 
float floatl; 


double doublel; 


float1 = 1.11111111111F; 
doublel = 1.1111111111111E+9D; 


System.out.println("f10atl = "+ float1); 
System.out.println("doublel = " + doublel); 


1 


Esta es la salida del código (observe que he sobrepasado la precisión 
permitida para un float, por lo que el valor se ha redondeado): 
C:\zjava app 


floatl = 1.1111112 
doublel = 1.1111111111111E9 


Declaración de variables de tipo carácter 


Se pueden declarar variables de tipo carácter con la palabra clave char. 
Para los posibles valores que se pueden almacenar en una variable char, ver 
también en este capítulo. 

Esto es un ejemplo en el que se declaran dos variables de tipo char: charl 
y char2. Este ejemplo prueba que se puede asignar a un char un código 
Unicode o un literal de tipo carácter (de hecho, el compilador traduce los 
literales de tipo carácter en códigos Unicode): 


public class app 
{ 


public static void main (String[l args) 


{ 


char charl, char2; 


charl = 65; 
char2 = B; 
System.out.println("charl = " + charl); 


System. cut. priotioi"chari = "= + chari): 


Este es el resultado del código: 


C:\=-javapp 
charl = A 
char2 = B 


A continuación veremos un punto clave que se tratará en un tema futuro: 
añadir parte de un texto al final del charl, convirtiéndolo a una cadena, e 
incrementar el valor de char2, cambiando de 'B' a 'C': 


public class app 
I 
public static void main (String[l args) 


I 


char charl, char2; 


charl 
char2 


65; 
'B': 


System.out.println("charl = " 
System.out.println("char2 = " char2); 
Sy-tcrm.out.println (-char+* = + charl + 1); 
¿yrten. out: printini*++obari=. " + ++chiri), 


charl); 


++ 


Esta es la salida de la nueva versión del programa: 


charl 
char2 = 
charl + = 
++char2 = C 


Al 


Declaración de variables de tipo booleano 


Las variables de tipo booleano se declaran con la palabra clave boolean. 
En Java, las variables de tipo booleano sólo pueden tener dos valores: verda- 
dero y falso (no valores numéricos como 0 y 1, como ocurre en otros lengua- 
jes de programación). 


Aquí tenemos un ejemplo en el que se declara y se usan dos variables de 
tipo booleano: 


public class app 
t 
public static void main(String[] args) 


{ 
boolean booleanl, boolean2; 


booleanl = trUe; 
boolean2 = false; 


System.o-t.println(-booleanl=- " + booleanl); 


System.out.println ("boolean2 = " + booleanl); 


Este es el resultado del código: 


C3 


\>java app 


booleanl = true 
boolean2 = false 


Generalmente, durante las pruebas, se usan valores booleanos para deter- 
minar el flujo de un programa. De momento, no diré más sobre ello y le 
daremos un repaso en el siguiente capítulo. En este caso, estoy usando dos 
tipos de variables con la sentenciaifde Java. Compruebo el valor de boolean] 
con la sentencia İf, haciendo que el código visualice el mensaje "booleanl es 
verdadero"”., si es verdadero (true)y "booleanl es falso”. en caso contrario: 


public class app 


{ 


1 


public static void main (String[l args) 


{ 


boolean booleanl, boolean2; 


booleanl = true; 
boolean2 = false: 


System.out.println("b00leanl = " + booleanl); 


If(booleanl) { 

System.o-t.println(-booleanles verdadero".); 
1 else ( 

System.o-t.println(-booleankes falso".); 
1 


El nuevo resultado es: 


C:X>Javaapp 

booleanl = true 
boolean2 = false 
booleanl es verdadero. 


Inicialización de variables 


"De acuerdo", dice el programador novato, "Ya lo tengo todo claro. Pri- 
mero, declaro una variable y después le asigno un valor”. "Realmente", le 
dice, "puede hacer las dos cosas en un solo paso". El PN contesta, "idígame 
cómo! - 

Pues bien, vamos a declarar variables y a asignarles valores de la siguiente 
forma: 


public class app 
I 


public static void main(String[l args) 


System.out.println("intl = " + intl); 


1 


Sin embargo, puedo combinar estos dos pasos en uno solo inicializando 
una variable cuando la declaro: 


public class app 
( 


public static void main (String[] args) 
int intl = 1; 


System.out.println("intl = " + intl); 


A continuación se indica cómo se declaran e inicializan varias variables: 


public class app 
( 


public static void main(String[] args) 


{ 
int intl = 1, int2 >= 2, int3 = 3; 


System.out.println("intl = + intl + 
, int3 = "+ int3); 


, int2 = + int2 + 
" 


1 
Este es el resultado del programa: 


C:\>java app 
intl = 1, int2 = 2, int3 = 3 


Inicialización dinámica 


Llegados a este punto, acabamos de asignar valores constantes a variables, 
pero se puede asignar cualquier expresión (una expresión es cualquier combi- 
nación de términos Java que da un valor) a una variable cuando es declarada, 
siempre que la expresión sea válida en ese momento. Por ejemplo, aquí se 
está asignando el valor 2 a intl y 3 a int2 y el valor de intl veces int2 a int3, 
usando el operador multiplicación de Java (*): 


public class app 
I 
public static void main(String[] args) 


{ 
int intl = 2, int2 = 3; 


int int3 = intl * int2; 


System.out.println("intl = " + intl + , int2 = "+ int2 + 
" , int3 = "+ int3); 


Esto es lo que nos devuelve el código cuando lo ejecutamos: 


C:\>java app 
intl = 2, int2 = 3, int3 = 6 


Observe que el compilador de Java no tiene ni idea de lo que valdrá intl 
veces int2 cuando crea los bytecodes para esta aplicación. Esto significa que 
el valor actual con el que int3 está inicializado será determinado en tiempo de 
ejecución, y es por lo que este proceso se llama inicialización dinámica. 

Al igual que en C++, en Java se puede introducir declaración de variables 
en el código, como se indica a continuación: 


public class app 
I 
public static void main(String[] args) 
I 
int intl = 2, int2 = 3; 


System. out .println ("intl = " + intl + ", int2 = " + int2); 


int int3 = intl * int2; 


Este es el resultado del código: 


C:i>java app 
intil = 2, int2 = 3 
int3 = 6 


Conversión de tipos de datos 


"Uf", dice el programador novato. "Me he atascado. Tengo una variable de 
tipo int y quiero asignarla a una variable de tipo byte, pero Java me devuelve 
un error "Tipo incompatible para =". ¿Qué es lo que está mal?" "Es un 
problema de conversión de tipos", le explica, "y tiene que usar explícitamen- 
te un cast de tipos”. "Hmm", dice PN, "¿cómo se hace eso?" 

Java es un lenguaje muy insistente con los tipos, y como consecuencia de 
ello, con frecuencia nos enfrentamos a la situación de asignar una variable de 
un tipo a una variable de otro. Hay dos formas de hacerlo: contando con una 
conversión automática y haciendo explícitamente un cast de tipos. Veámos- 
las. 


Conversiones automáticas 
A 
Cuando asigna un tipo de dato a una variable de otro tipo, Java convertirá 
el dato al nuevo tipo de variable de forma automática si las dos condiciones 
siguientes son verdaderas: 


e Los tipos del dato y de la variable son compatibles. 


e El tipo de destino tiene un rango mayor que el de origen. 


Por ejemplo, se puede asignar un valor de tipo byte a una variable int, ya” 
que byte e int son tipos compatibles y las variables int tienen un rango mayor 
que los valores byte. Por lo tanto, no se perderá ningún dato en la conversión 
de tipos. Esto es un ejemplo: 


public class app 
{ 


public static void main(String[l args) 
( 

byte bytel = 1; 

int intl; 


intl = bytel; 


System.out.println("intl1l = " + intl); 


El compilador de Java no tiene ningún problema con este código y hace la 
conversión de tipos automáticamente. Este es el resultado del programa: 

c:X>java app 

intl = 1 

Este tipo de conversiones, en las que se convierte a un tipo de datos que 
tiene mayor rango, se llaman extensión de conversiones. En ellas, los tipos 
numéricos, como entero o coma flotante, son compatibles entre sí. Por otro 
lado, los tipos char y boolean no son compatibles entre sí y tampoco con los 
tipos numéricos. 


Casting a nuevos tipos de datos 


Si se está asignando un valor que es de un tipo con un rango mayor que la 
variable a la que se le está asignando, se está ejecutando lo que se denomina 
estrechamiento de conversiones. El compilador de Java no las ejecuta 
automáticamente, ya que se perdería la posibilidad de precisión. 

Si se quiere hacer un estrechamiento de conversiones, se debe usar explí- 
citamente un cast, que tiene el siguiente formato: 


(tipo de dato de destino) valor 


Por ejemplo, en este código, se está convirtiendo un tipo entero a un tipo 
byte: 

public class app 

I 


public static void main(String[l args) 


{ 
byte bytel; 
int intl = 1; 


bytel = (byte) intl; 


System.out.println("bytel = + bytel); 


1 


Si no se hace explícitamente el cast, el compilador devolverá error, pero 
con el cast de tipos, no hay problema, ya que Java decide que se conoce la 
posibilidad de perder algunos datos cuando se introduce un valor probable- 
mente mayor en un tipo más pequeño. Por ejemplo, cuando se pone un 
número en coma flotante en un long, la parte fraccional del número se trunca- 


rá, y puede que se pierdan más datos si el valor en coma flotante está fuera del 
rango que un long puede gestionar. Esta es la salida del código: 


C:\>javaapp 
bytel = 1 


Algo a tener en cuenta es que el compilador de Java convierte a un tipo de 
mayor precisión, si es necesario, al evaluar expresiones. Por ejemplo, vamos 
a considerar el siguiente código, en el que parece que sólo hay bytes 
involucrados: 


public class app 
I 


public static void main (String[] args) 


{ 


byte bytel 
byte byte2 
byte byte3; 


100; 
100; 


byte3 = bytel * byte2 /100; 


Por lo tanto, como Java sabe que de la multiplicación de tipos puede 
resultar valores del tamaño de un entero, automáticamente convierte el resul- 
* A . 
tado de bytel * byte2 en un entero, lo que quiere decir que realmente hay que 
usar explícitamente un cast para mantener el tipo byte: 
public class app 
public static void rnain(String[] args) 
( 
byte bytel = 100; 
byte byte2 = 100; 
byte byte3; 
byte3 = (byte) (bytel * byte2 / 100); 


E uf. .printir yte] + byte 


Este código se compila y se ejecuta como esperábamos, pero no sería así 
sin el cast (byte): 


C:\>java app 
byte3 = 100 


Dec:laraciónde arrays unidimensionales 


El gran jefe aparece y dice, "Es hora de atacar a los clientes que nos deben 
facturas”. "De acuerdo", le dice, "¿puedo ver las cuentas?" "Realmente, nun- 
ca guardamos las cuentas”, dice el GJ. "Ah", le contesta. "Creo que tendré 
que crear un array para almacenar las cuentas”. 

Como ya vimos antes en este capítulo, los arrays proporcionan una forma 
fácil de gestionar un conjunto de datos por medio de un índice, lo que es fácil 
para los ordenadores, ya que se puede manipular el índice en el código. Java 
soporta arrays unidimensionales y multidimensionales, y ambos los veremos 
aquí. 

Para tener un array preparado es necesario ejecutar dos pasos. Primero, se 
debe declarar el array. A continuación se indica cómo se declara, en general, 
un array unidimensional: 


tipo nombre [] ; 


Por ejemplo, así es como se declara un array de valores double, que se 
llama accounts[]: 


public class app 

{ 
public static void main(String[] args) 
I 


double accounts[1 ; 


103 


Al igual que al declarar variables sencillas, la declaración de un array no 
reserva memoria, ya que Java no sabe exactamente qué tamaño va a tener. 
Esto quiere decir que es necesario otro paso en este proceso: la creación del 
array. Veamos el siguiente punto para más detalles. 


Creación de arrays unidimensionales 


Después de que se ha declarado un array unidimiensional, el siguiente 
paso es crear ese array alocando memoria para él. Como se verá en el capítulo 
o usar el nuevo array de la siguiente forma: 

public class app 
I 
public static void main (String[l args) 


I 


double accounts[!l; 

accounts = new double[100]; 

accounta [3] = 1535.67, 

System.out.println("Lacuenta 3 debe $" + accounts[31); 
1 


Aquí se ha creado un array de exactamente 100 valores double, que Java 
inicializa a O. El límite inferior de todo array de Java es O, por lo que el 
primer elemento del array es accounts[O] y el superior es accounts[99]. Si el 
índice del array está fuera del rango del O al 99, Java devolverá un error fatal, 
y el programa se parará. 

Este es el resultado del programa: 


C:Xzjava app 
La cuenta 3 debe $1335.67 


De hecho, se puede combinar el proceso de declaración y creación de - 
arrays en un paso: 


public class app 


I 
public static void main(String[] args) 


{ 


double accounte[ ] = new double [1001; 


system.out.println("La cuenta 3 debe $" + accountsi31); 


Inicialización de arrays unidimensionales 


El programador novato regresa con una pregunta. "Sé que puedo inicializar 
variables sencillas cuando las declaro”, dice, "pero ¿puedo hacer lo mismo 


con los arrays?" "Sin problema", le dice. 


Para inicializar los arrays unidimensionales, únicamente hay que poner 
los valores entre llaves, un valor detrás de otro, separados por comas, empe- 
zando con el primer valor del array. Este es un ejemplo que inicializa los 


primeros cuatro elementos del array accounts[ ] con datos: 


public class app 
I 


public static void main (String[l args) 


{ 
double accounts[l = C238.45, 999.33, 0, 1335.67); 


System.out.println("Lacuenta 3 debe $" + accounts[31); 


Declaración de arrays multidimensionales 


"Hmm", dice pensativo el programador novato, "creo que necesito más 
que un array unidimensional. Estoy pensando en mantener los productos 
indexados por número de producto, y el array supongo que almacenará el 
número de artículos del inventario, su coste, las ventas, el número"... "Man- 


téngalo", le dice. "Utilice un array multidimensional". 


Se pueden declarar arrays multidimensionales de la misma forma que se 
declaran los unidimensionales; sólo con incluir un par de corchetes para cada 


dimensión del array. 


tipo nombre[] illl.  .; 


Ya vimos anteriormente, en este capítulo, cómo declarar un array de dos 


dimensiones con dos filas y 100 columnas: 


public class app 
{ 


public static void main(String[l args) 


double accounts[1 [l = new double[2Z1I [1001; 


Así funcionan losarrays de dos dimensiones: el índice izquierdo especifi- 
ca la fila y el derecho, la columna. 

Por supuesto, no tiene por qué limitarse a las dos dimensiones, aquí tiene 
cómo declarar un array de cuatro dimensiones: 


public class app 
I 
public static void main(String[] args) 
I 
double accounts[1 [1[1 [1 = new double[Z] [31 [41[51 


Como puede observar, es tan fácil declarar arrays multidimensionales 
como declararlos unidimensionales. Ahora, ¿cómo se crea un array después 
de haberlo declarado? Ver el siguiente punto para más detalles. 


Creación de arrays multidimensionales 


El programador novato pregunta, "Ahora que he declarado un nuevo array 
multidimensional, ¿cómo lo creo?" "Veámoslo", le dice. 

Con el operador new se crea Un nuevoarray multidimensional reservándo- 
le memoria y dándole las dimensiones que se quiera. Veámoslo con un 
ejemplo: 


public class app 

t 
public static void main (String[] args) 
I 


double accounts[1[1:; 
accounts = new double[2] [100]; 


ac canta E +5 


System.out.println("Lacuentade ahorro 3 tiene $" + accounts[01[31); 
System.out .println("La cuenta corriente 3 tiene $" + 
accounts[11 [31); 
1 
1 


Este es el resultado del código: 


C:il>java app 
La cuenta de ahorro 3 tiene $43.95 
La cuenta corriente 3 tiene $2.3854893820639 


Además, la declaración y reserva de memoria se pueden hacer en un solo 
paso: 


public class app 


public static void main(String[] args) 


{ 
double accounts = new double[2] [1001; 


de 


Account a 


-commes[1)[3] = 2105409302.0 


System.out.println("Lacuentade ahorro 3 tiene $" + accounts [OI [31); 
System.out.println "La cuenta corriente 3 tiene $" + 
accounts[11 [31); 
1 
1 


En este ejemplo se crea y utiliza un array de cuatro dimensiones: 


public class app 
{ 
public static void main (String[l args) 
{ 
double accounts[1l 11 [l1 [l = new doublet21 131 [41 [SI; 
accounts [01 [1] [21 [31 = 43.95; 


System.out.println("Lacuenta [O] [1] [21 [31 tiene $" + 
accounts [O1 [11 [21 [31); 
1 
1 


Este es el resultado del programa: 


C:\>java app 
La cuenta [O] [11 [21 131 tiene $43.95 


Los arrays multidimensionales son realmente arrays de arrays, lo que 
significa que si se tiene un array de dos dimensiones (array[][]), se puede 
tratar como unarray de arrays unidimensionales, al que se puede acceder con 
array[O], array[1], array[2] y así sucesivamente. Hay una manera sencilla de 
hacer esto utilizando un bucle for (del que veremos más en el siguiente 
capítulo) y el método length (que veremos en las siguientes secciones) para 
averiguar la longitud de un array: 


public class app 
1 
public static void main(String[] args) 


( 
double array[l [I = 1{1, 2, 3). 


int sum = 0, total = 0; 


for (int outer—index = 0; outer-index < array.length; 
outer—-index++) 1 
for (int inner—index = 0; inner—index < 
array [outer—-indexl.length; inner-incfex++) C 


sum += array[outer-index] [inner—-indexl; 
total++: 


System.out .println("Valormedio del array = "+ (sum/ total)) 5 


1 
Este es el resultado del código: 


C:>\java app 
Valor medio del array = 2 


Hasta ahora, todos los arrays que hemos utilizado tenían el mismo núme- 
ro de elementos en cada dimensión, pero no es necesario que sea así. Para 
aprender más, se puede echar un vistazo a la sección que viene después de la 
siguiente. Primero, veamos cómo se inicializan los arrays multidimensionales. 


Inicialización de arrays multidimensionales 


Los arrays multidimensionales se pueden inicializar cuando se los decla- 
ra, de la misma forma que se inicializan los unidimensionales; basta con 
incluir un par de corchetes para cada dimensión y poner los valores con los 


que se quiere inicializar el array dentro de los mismos. Por ejemplo, aquí 
vemos cómo se inicializa un array de dos dimensiones: 


public class aPP 


public static void main (String[] args) 
{ 
double accounts[ ][ ] = {{10.11, 19.56, 4343.91, 43.951, 


{11.23, 54.23, 543.62, 
2385489382. 06) ) ; 


System.out.println("Lacuenta de ahorro 3 tiene $" + 
accounts [O1 [31); 


System.out.println("Lacuenta corriente 3 tiene $" + 
accounts[11 131); 


1 
La ejecución del código produce: 
C:X>Java app 


La cuenta de ahorro 3 tiene $43.95 
La cuenta corriente 3 tiene $2.3854893820639 


Creación de arrays multidimensionales 


"De acuerdo", dice orgulloso el progamador novato, "ya soy un experto en 
arrays". "Ah, ¿sí?", le dice. "¿Sabe cómo poner diferente número de elemen- 
tos en cada fila de un array?" El PN dice, disculpe?" Como en otros 
muchos lenguajes de programación, en Java, los arrays multidimensionales 
son arrays de arrays. Esto quiere decir que se pueden construir arrays como 
se quiera; como en el ejemplo, en el que cada fila de un array de dos 
dimensiones tiene un diferente número de elementos: 


public class app 
{ 


public static void main (String[l args) 
I 
double array[ 1[ 1 = new double [51[ 15 


array[O] = new double[5001; 
array[1] = new double[4001; 
array[21 = new double[3001; 
array[3] ə new double 12001 ; 
array 141 = new double [1001 ; 


Systern.out.println("Lacuenta [3](31 tiene $" + array[31 [31)5 
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Lo que ocurre aquí es que se está tratando cada fila de un array de dos 
dimensiones como un array unidimensional y creando cada uno de esos 
arrays unidimensionales de forma separada. Este es el resultado del código: 


C:X>java app 
La cuenta [31[31 tiene $1335.67 


Longitud de un array 


Con frecuencia, es útil conocer la longitud de un array, especialmente si 
se está iterando sobre todos los elementos del array dentro del código. Para 
saber el número de elementos de un array llamado array 1, se puede usar el 
término arrayl.length. Este es un ejemplo del capítulo siguiente, que utiliza 
el bucle for para calcular el grado medio de un estudiante entre un grupo de 
seis grados (en este caso, grades.length devuelve el valor 6): 


public class app 


{ 
public static void mainíString[] args) 


{ 
double grades[l = 188, 99, 73, 56, 87, 64); 


double sum, average; 


for (int loop—index = 0; loop—index < grades.length; 
loop-index++) { 
sum += grades [loop-index]; 


average = sum / grades.length; 
System.out.println("Grado medio = " + average); 
1 
Este es el resultado: 


C:i>java app 
Grado medio = 77.83333333333333 


La clase String 


"He estado revisando la lista de tipos de datos sencillos de Java", dice el 
programador novato, "y no encuentro las cadenas de texto. ¿No deberían 


estar ahí?” "Algunas personas dicen que sí, "le responde, "pero, de hecho, en 
Java, las cadenas se gestionan como si fueran objetos. Una de las ventajas de 
esto es que un objeto de tipo string tiene gran variedad de métodos que se 
pueden usar". 

En muchos lenguajes, las cadenas de texto son tipos de datos fundamenta- 
les inherentes al lenguaje, pero en Java, las cadenas son gestionadas con las 
clases String y StringBufSer. Veamos primero la clase String. 

Los objetos de tipo string gestionan las cadenas de texto que no se pueden 
cambiar; si se quiere cambiar el texto actual de la cadena, se debería usar la 
clase StringBuffer. Este es un ejemplo en el que se crea una cadena y se 
visualiza (observe cómo este código hace la clase String como si fuera otro 
tipo de dato sencillo): 


public class app 
{ 


public static void main (String[] args) 


{ 


String sl = "¡Hola desde Java!": 


Este es el resultado: 


C:\>java app 
¡Hola desde Java! 


La clase String es muy poderosa, pues con los métodos que proporciona 
permite convertir la cadena en un array de caracteres, convertir números en 
cadenas, buscar cadenas, crearsubstrings, cambiar la cadena de mayúsculas a 
minúsculas o viceversa, obtener la longitud de la cadena, comparar cadenas y 
mucho más. 

La clase String es una clase, no un tipo de dato intrínseco, lo que significa 
que se crean objetos de esa clase con constructores, de los que aprenderá todo 
lo necesario en el capítulo 4. Un constructor es como un método normal de 
una clase, salvo cuando se usa para crear un objeto de esa clase. Aquí verá 
una rápida presentación de los constructores de la clase String. La clase 
String tiene, además, un miembro de datos que se usa cuando se comparan 
cadenas (lo veremos en el siguiente capítulo). Este miembro de datos se 
muestra en la tabla 2.2. Los constructores de la clase String que se pueden 
usar para crear objetos String (ver la sección "Creación de cadenas”, en este 
capítulo), aparecen en la tabla 2.3 y los métodos de la clase String aparecen 
en la tabla 2.4. 
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Estas tablas se usarán en las siguientes secciones, en las que crearemos y 


usaremos objetos de String. 


Tabla 2.2. Resumen de los campos de la clase String. 


Static Comparator 
CASE-INSENSITIVE-ORDER 


Descripción 


Permite la ordenación de objetos 
String, en comparación con Tolg- 
norecase. 


Tabla 2.3. Resumen de los constructores de la clase String. 


Constructor 


Stringi | 


String(byte[ ] bytes) 


String(byte[ ] ascii, int hibyte) 


String(byte[ ] bytes, int offset, int 
length) 


String(byte[ ] ascii, int hibyte, int offset, 


int count) 


String (byte[ ] bytes, int offset, enc) 


String (byte[ ] bytes, String enc) 


String(char[ ] value) 


Descripción 


Inicializa un nuevo objeto String 
para gestionar un secuencia de 
caracteres vacía. 


Construye un nuevo objeto String | 
convirtiendo el array de bytes 

mediante la codificación de carac- 

teres que tiene la plataforma por | 
defecto. 


Obsoleto. Este método no convier- 
te bien los bytes en caracteres. 


Construye un nuevo objeto String 
convirtiendo el subarray de bytes 
usando la codificación de caracte- 
res por defecto. 


Obsoleto. Este método noconvier- 
te bien bytes en caracteres. 


Construye un nuevo objeto String 
convirtiendo el entero length y el 
subarray de caracteres utilizando 
la codificación de caracteres espe- 
cificada. 


Construye un nuevo objeto String 
convirtiendo el array de bytes 
mediante la codificación de ca- 
racteres que se especifica. 


Aloca un nuevo objeto String para 
representar la secuencia de carac- 


Constructor Descripción 


teres contenida en el argumento 
array de caracteres. 


String(char[] value, int offset, int count) Aloca un nuevo objeto String que 
contienecaracteresde un subarray 
del array de caracteres del argu- 
mento. 


String(Stringvalue) Inicializa un nuevo objeto String 
para que represente la misma 
secuencia de caracteres que el ar- 
gumento. 


String(StringBuffer buffer) Aloca un nuevo objeto String que 
contiene la secuencia de caracte- 
res del argumento buffer. 


Tabla 2.4. Métodos de la clase String. 


Método Descripción 

char charAt(int index) Proporciona el carácter del índice 
especificado. 

int compareTo(Object o) Compara este objeto String con 
otro. 


int compareTo(String anotherstring) Compara lexicográficamente dos 
cadenas. 


int compareTolgnoreCase(String str) Compara lexicográficamente dos 
cadenas ignorando mayúsculas o 
minúsculas. 


String concat(String str) Concatena la cadena dada al final 
de esta cadena. 


Static String copyValueOf(char[ ] data) Produce un objeto de tipo String 
que es equivalente al array de 
caracteres dado. 


Static String copyValueOf(char[ ] it Produce un objeto de tipo String 
offset, int count) con datos equivalentes al array de 
caracteres dado, usando offsets. 


boolean endsWith(String sufijo) Verdadero si esta cadena termina 
con el sufijo dado. 


KE 
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Metodo 


boolean equals(Object un objeto) 


boolean equalsignoreCase(String otra 


cadena) 


bytel ] getBytes 


void getBytes(int srcBegin, int srcEnd, 


byte[ ] dst, int dstBegin) 
byte[ ] getBytes(String enc) 


void getBytes(int srcBegin, int srcEnd, 


char[ ] dst, int dstBegin) 
int hashCode() 


int indexOf(int ch) 


int indexOf(int ch, int fromIndex) 


int indexOf(Sting str) 


int indexOf(String str, int fromIndex) 


String intern( ) 


Descripción 


Compara esta cadena con un 
objeto. 


Compara este objeto String con 
otro objeto, ignorando las mayúscu- 
las. 

Convierte este objetostringen by- 
tes, de acuerdo con la codificación 
de caracteres por defecto y alma- 
cenando el resultado en un nuevo 
array de bytes. 


Obsoleto. Este método no convier- 
te bien caracteres a bytes. 


Convierte este objetostringen by- 
tes de acuerdo con la codificación 
de caracteres dada, almacenando 
el resultado en un nuevo array de 
bytes. 


Copia caracteres de esta cadena 
en el array de destino. 


Produce un hashcode para esta 
cadena. 


Proporciona el índice, dentro de la 
cadena, de la primera vez que 
aparece el carácter dado. 


Produce el índice, dentro de la 
cadena, de la primeravez que apa- 
rece el carácter dado empezando 
por el índice especificado. 


Proporciona el índice, dentro de la 
cadena de la primera vez que 
aparece elsubstringespecificado. 


Produce el índice, dentro de la 
cadena, de la primeravez que apa- 
rece elsubstringdado, empezando 
por el índice especificado. 


Produce una representación para 
el objeto String. 


Método 


Descripción 


int lastindexOf(int ch) 


int lastindexOf(intch, int fromIndex) 


int lastindexOf(String str) 


Devuelve el índice, dentro de la 
cadena, de la última ocurrencia del 
carácter especificado. 


Produce el índice, dentro de la ca- 
dena de la última ocurrencia del 
carácter dado, buscando hacia 
atrás desde el índice especificado. 


Devuelve el índice, dentro de la 
cadena, de la ocurrencia más a la 
derecha del substring dado. 


int lastindexOf(String str, int frornindex) Produce el índice dentro de esta 


int length() 


boolean regionMatches String other, 
(boolean ignorecase, int toffset, int 
ooffset, int len) 


boolean regionMatches(int toffset, 
String other, int ooffset, int len) 


String replace (char oldChar, char 
newchar) 


boolean startsWith(String prefix) 


boolean startswith (String prefix, int 
toffset) 


String substring(int beginIndex) 
char[ ] to CharArray] ] 


String toLowerCase( ) 


cadena de la última ocurrencia del 
substring dado. 


Devuelve la longitud de la cadena | 


Compruebasidosregiones de cade- 
nas son iguales, permitiendo igno- 
rar las mayúsculas. 


Chequea si dos regiones de cade- 
nas son iguales. 


Produce una nueva cadena situan- 
dotodas las ocurrencias de oldChar 
en esta cadena con newchar. 


Chequea si esta cadena empieza 
con el prefijo dado. 


Chequea si esta cadena empieza 
con el prefijo dado empezandocon 
el índice dado. 


Produce unanuevacadena que es 
una subcadena de esta. 


Convierte estacadena en un nuevo 
array de caracteres. 


Convierte a minúsculas todos los 
caracteres de este objeto String, 
usando las reglas del defecto local, 
que es devuelto por Locale.getDe- 
fault. 
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Metodo 


String toLowerCase(Locale locale) 


| String toString() 


String toUpperCase( ) 


String toUpperCase (Locale locale) 


String trim( ) 
Static String valueOf(boolean b) 
Static String valueOf(char c) 


Static String valueOf(char[ ] data) 


Static String valueOf(char[ ] data, 
offset, int count) 


| Static String valueOf(double d) 
Static String valueOf(float f) 


Static String valueOf(int i) 


Static String valueOf(long % 


| Static String valueOf(Object obj) 


Descripción 


Convierte a minúsculas todos los 
caracteres de este objeto String, 
usando las regalas del argumento 
locale especificado. 


Se devuelve este objeto (que ya es 
una cadena). 


Convierte a mayúsculas todos los 
caracteres de este objeto String, 
utilizando las reglas del locale por 
defecto, que es devuelto por Loca- 
le.getDefault. 


Convierte a mayusculas todos los 
caracteres de este objeto String, 
usando las reglas del locale dado. 


Elimina el espacio en blanco desde 
ambos finales de esta cadena. 


Produce la representación de la 
cadena del argumento booleano. 


Produce la representación de la 
cadena del argumento char. 


Produce la representación de la 
cadena del array de caracteres | 
que se pasa como argumento. 


Produce la representación de la 
cadena de un subarray específico 
delargumentochararraydeenteros. 


Produce la representación string 
de un double. 


Produce la representación string 
de un float. 


Produce la representación string 
de un int. 


Produce la representación string 
de un long. 


Produce la representación string 
de un object. 


Creación de cadenas 


"Entonces, Java incluye una clase String para gestionar las cadenas de 
texto", dice el programador novato. "Eso es fabuloso, porque estoy escribien- 
do esta novela, mire, y”.... "Mantengámoslo", le dice. "No quiero saber nada 
más sobre eso". 

Echemos un vistazo a algunas de las muchas formas de crear objetos 
String. Esta es una forma que ya hemos visto: 


public class app 


public static void main(String[] args) 


I 
String S1 = hola desde Java!"; 


De hecho, cuando en el código se usa un literal de cadena como "¡HOla 
desde Java!", Java lo trata como un objeto String; por tanto, lo que realmente 
está ocurriendo es que se está asignando un objeto String a otro. 

Por supuesto, se puede declarar una cadena primero y luego asignarle un 
valor: 


public class app 
{ 
public static void main (String[l args) 


{ 


String sl = "¡Hola desde Java!"; 
String 82; 
s2 = "iHola desde Java!"; 


Este es un caso en el que usamos uno de los constructores de la clase 
String. En este caso, se crea una cadena vacía y luego se le asignan datos: 


public class app 


1 
public static void main (String[] args) 


{ 


String sl = "¡Holadesde Java! " ; 
String s2; 
~2 = "i-olaesde Java!"; 


String 83 = new String( ); 
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83 = hola desde JavalIm; 


Además al constructor de la clase String se le puede pasar, directamente, 
una cadena de texto para crear una nueva cadena, como sigue: 

public class app 

I 


public static void main (String[l args) 


( 


String sl = "¡Hola desde Java!"; 


String s2; 
s2 = "¡Hola desde Java! ” ; 


String s3 = new Stringo; 
s3 = "¡Hola desde Java!"; 


String s4 = new String("iHola desde Javai*); 


Hay otros constructores de la clase String que pueden tomar arrays de 
caracteres o subconjuntos de arrays de caracteres (la clase String sabe qué 
constructor se está usando por el número y tipo de argumentos que se le 
pasan). Incluso se puede usar el método valueOf de la clase String para 
obtener una representación, en cadena, de valores numéricos: 

public class app 

I 

public static void mainíString[l args) 


I 


String sl = ";Hola desde Java!"; 


String s2; 
s2 = "¡Hola desde Java! "5; 


10) 


tring s3 = new Stringo; 
s3 = "[Holadesde Java!" ; 


String s4 = new String("iHoladesde Java!"); 


Char cl[ ] = {\H., tor, M', lar, * +, —-a*, nhn, +iís>; 
String 85 = new String (c1); 


String s6 = new String(cl, O, 4); 


double doublel = 1.23456789; 
String s7 = String.~alueoOf (doublel); 


5yeten-cuE.printiniel); 
Syaten.cut printinisibr 
5ystén.our.printin(ed); 
Syatem.cout.printinisóh5 
Gya taa. gut princinieas5); 
Sruten.cut printinisTi; 


Al final de este código, visualizamos todas las cadenas que se han creado. 
Esto es lo que aparecería al ejecutar el programa: 


C:i>java app 
¡Hola desde Java! 
¡Hola desde Java! 
¡Hola desde Java! 
¡Hola desde Java! 
Hola ahí 

Hola 

1.23456789 


Obtención de la longitud de la cadena 


El programador novato está sin aliento. "He escrito la mitad de mi nove- 
la", dice, "y necesito averiguar cuánto me queda. ¿Cómo puedo hacerlo?" 

"Use el método length de la clase String", le dice. 

Este es un ejemplo en el que se muestra cómo se usa el método length de 
la clase String (observe que además se puede ver que Java trata los literales 
cadena como objetos String usando length en un literal de cadena): 


public class app 
I 
public static void main(String[l args) 


{ 


String sl = "¡Hola desde Java!"; 


SvÑstbem.aut. printila" + gi + "14" + * jg + B8l.lengthli 
+ " characters long".); 

System.out.println(''X""+ "Hola" + "X"">+ " tiene " + 
"Holan.length()+ ' caracteres".); 


Esta es la salida del programa: 


C:X>java app 
" ¡Holadesde Java!" tiene 17 caracteres 
"Hola" tiene 4 caracteres. 


Concatenación de cadenas 


La concatenación de cadenas significa ponerlas juntas, y ya hemos usado 
el operador + en este libro para hacer esto. Sin embargo, hay otra forma de 
concatenar cadenas, se puede usar el método concat de la clase String para 
unir dos cadenas y crear una nueva. ¿Cómo se programa eso? Este es un 


ejemplo en el que se usa tanto el operador + como el método concat para 
crear la misma cadena: 


public class app 


{ 
public static void main (String[l args) 


( 


String sl = "¡Holav; 


String s2 = sl + desde"; 
String s3 = 82 + m Java!l; 


String s4 = sl.concat (" desde”); 
String s5 = s4.concat(" Javaln); 
System.out.println(c3); 
System.out.println(s5); 


) 
Este es el resultado del código anterior: 


C:Xzjava app 
¡Hola desde Java! 
¡Hola desde Java! 


Como ya ha visto, a la hora de visualizar números, cuando se concatena un 


valor numérico con una cadena, el valor numérico se concatena como una 
cadena. 


Truco: observe que al concatenar números hay que tratarlos como 
cadenas; por lo tanto, hay que tener cuidado. Por ejemplo, 
System.out,printin("3 43 =" +3 +3) visualiza 3+3=33,n03+3=6. 


Obtención de caracteres y substring 


La clase String proporciona un número de métodos que descompone las 
cadenas en sus componentes, caracteres y substring. Por ejemplo, se puede 
usar el método charAt para obtener el carácter que ocupa una posición deter- 
minada: 


public class aPP 


{ 
public static void main (String[] args) 


{ 
String sl = "¡Hola desde Java!"; 


char cl = sl.charat (0); 
system.out.println("El primer carácter de \"" + sl + 
"\" es " + cl); 


Se puede usar el método toCharArray para convertir un objeto String en 
un array de caracteres, y se puede usar el método getChars para obtener un 
número de caracteres: 


public class app 

( 
public static void main(String[] args) 
I 


String s1 = "¡Hola desde Java!"; 


char cl = sl.charAat (0); 
System.out.println("El primer carácter de 1"" + sl + 
"\" es "+ cl); 


char charsl1[ 1 = sl.toCharArray( ); 
System.out.println("El segundo carácter de \"" + 
sl + *"1* es " + chars1[11; 


char chars2[ 1 = new charl51; 
sl.getChara(0. 5, chars2, 0); 
System.out.println("Los primeros cinco caracteres de 1"" + sl 


+ "MX" son + new String(chars2)); 


Además, puede usar el método substring para crear una cadena nueva que 
es un substring de la antigua, como sigue: 


public class app 
{ 


public static void main (String[l args) 
1 
String sl = "¿Hola desde Java! "; 


char cl = sl.charAt (0); 
System.out.println("Elprimer carácter de 1"" + slte 
"YN" es " + cl); 


char chars1[1 = sl.toCharArray(); 
System.out .println(El segundo carácter de 1"" + 
sl + "\" es " + chars1[1]);5 


char chars2[1 = new char[5]; 

sl.getChars(0,5, chars2, 0); 

System.out.println("Loc primeros cinco caracteres de \"" + sl 
+ "MX" son "+ new String(chars2)); 


String s2 = sl.substring(0, 5); 


System.out.println("Los primeros cinco caracteres de 1"" + sl 
+ "MX" son " + s2); 


Este es el resultado del programa: 


C:X>Java app 


El primer carácter de "¡Hola desde Java!" es i 

El segundo carácter de "¡Hola desde Java!" is H 

Los primeros cinco caracteres de ";Holadesde Java!" son ¡Hola 
Los primeros cinco caracteres de "¡Hola desde Java!" son ¡Hola 


Búsqueda y reemplazamientos en cadenas 


Se pueden buscar caracteres y substrings utilizando los métodos indexOf y 
lastIndexOf. El método indexOf devuelve el lugar, tomando como base el 
cero, de la primera ocurrencia del carácter o substring en una cadena y 
lastIndexOf' devuelve la localización de la última ocurrencia de un carácter o 
substring. 


Esto es un ejemplo que prueba como se usa indexOf y lastIndexOf: 


public class app 
I 
public static void main(String[] args) 


( 
String sl = "He dibujado un bonito dibujo”.; 


System.out.println("La primera vez que aparece X"dibul" es pen 
"en la posición " + sl.indexof ("dibun)); 


System.out.println("-a última vez que aparece MX"dibul" es + 


"en la posición " + sl.lastIndex0f ("dibu")); 


La clase String tiene también el método replace, que permite reemplazar 
todas las ocurrencias de un carácter simple por otro carácter. Quizás piense 
que esto va en contra de la idea de no poder cambiar el texto en un objeto 
String; sin embargo, este método crea un nuevo objeto String. Esto es un 
ejemplo que muestra cómo funciona (observe que se están cambiando todas 
las ocurrencias de la letra h por la letra f en una cadena de texto): 


public class app 
I 


public static void main(String[l args) 


{ 


String sl = "He dibujado un bonito dibujo".; 
System.out.println ("La primera vez que aparece \"dibu\"es " + 
''enla posición " + sl.indexOf ("dibu"); 


System.out.println("Laúltima vez que aparece \"dibu\"es " + 
"en la posición " + sl.lastIndex0f ("dibu")); 


String s2 = "Ecina, you're hired!"; 
System.out.println(s2.replace (Ihr, 'f')); 


Este es el resultado del código: 


C:X>java app 

La primera vez que aparece "dibu"es en la posición 3 
La última vez que aparece "dibu"es en la posición 22 
Edna, you're fired! 


Cambio de mayúsculas a minúsculas 
(o viceversa) en cadenas 


El programador novato dice, "El gran jefe me dijo que la salida de mi 
programa no tenía énfasis suficiente. ¿Tiene alguna sugerencia?” "Intente 
usar el método UpperCase We dice. 

Se puede usar el método toLowerCase para convertir a minúsculas una 
cadena, y el toUpperCase para convertirla en mayúsculas. Así sería el 
código: 
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public class app 
( 
public static void main(String[l args) 
( 
Syst-.o-t.println(-yEloldesde Javalm.tolLlmrCase( )); 
System.out.println(";¡Aola desde Javaln.toUpperCase( )1l; 


) 
Este es el resultado del programa: 
C:X>java app 


ihola desde java! 
; HOLA DESDE JAVA! 


Formateo de números en cadenas 


Se pueden formatear números en cadenas utilizando la clase Number- 
Format del paquete java.text. Esta clase soporta los métodos formar, set- 
Minimum-Integer-Digits, set-Minimum-Fraction-Digits, set-Maximum-integer- 
Digits y set-Maximum-Fraction-Digits. Esto es un ejemplo, en el que se usa 
el método set-Maximum-Fraction-Digits, redondeando un valor double al 
formatearlo: 


import java.text.*; 


public class app 
( 


public static void main(String[] args) 
I 
double value = 1.23456789; 
NumberFormat nf = NumberFormat .getNumberInstance0; 
Mi. setas FraotionDigite(6l, 


String s = nf.format (value); 


System, out printinisl 


Este es el resultado: 


La clase StringBufferr 


"Hmm", dice el programador novato. "He almacenado toda mi novela en 
un objeto String y ahora no puedo cambiarlo. ¿Qué problema hay?" "No 


puede cambiar el texto en el objetoStringUle dice. "Tiene que usar un objeto 
StringBuffer en su lugar". "Entonces, cuénteme", contesta el NP. 

La clase StringBuffer le da tanto y más como lo que ofrece la clase String: 
la posibilidad de modificar la cadena actual. Este es un ejemplo en el que se 
usa el método replace de la clase StringBuffer para cambiar el contenido de 
un objeto StringBuffer de "¡Hola desde Java!" a "¡Hola a Java!": 


public class app 
( 


public static void main (Stringtl args) 


í 
StringBuffer sl = new StringBuffer ("iHoladesde Java!"); 


sl.replace(6, 11, "a"); 
Syetan. cout. .printinisl]; 


Este es el resultado del código: 


C:X>Java app 
¿Holaa Java! 


Creación de StringBuHers 


Se pueden crear objetos StringBuffers usando los constructores de la clase 
StringBuffer. Por ejemplo, aquí tenemos cómo se crea un objeto StringBuffer 
vacío (que se inicializa con 16 espacios en blanco, por defecto) y luego 
introducimos algo de texto: 


public class app 
I 


public static void main(String[l args) 


( 


StringBuffer sl = new StrinBufferi 1; 
sl.insert(0, mlHoladesde Javaln); 


Tabla 2.5. Constructores de la clase StringBuffer. 


Constructores Descripción 


StringBuffer() Construye un bufferde ti postring, sin caracteres 
y con una capacidad de 16 caracteres. 
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Constructores 


StringBuffer(int length) 


Descripción 


Construye unbufferde tipostring, sin caracteres 


y con la capacidad marcada por el argumento 


length. 
StringBuffer(String str) 


Construye unbufferde tipostringque representa 


la misma secuencia de caracteres que el argu- 


mento. 


Tabla 2.6. Métodos de la clase StringBuffer. 


Método 


StringBuffer append(boolean b) 


StringBuffer append(char c) 


StringBuffer append(charl[ ] str) 


StringBuffer append(char| ] str, int 
offset, int len) 


StringBuffer append(doub1ed) 
StringBuffer append(float f) 


StringBuffer appena(inti) 


| StringBuffer append(long %) 


StringBuffer append(Object obj) 
StringBuffer append(String str) 


Char charAt(intindex) 


Descripción 


Añade al buffer la representación 
string del argumento booleano. 


Añade al buffer la representación 
string del argumento char. 


Añade al buffer la representación 
string delarrayde caracteres pasado 
como argumento. 


Añade la representación string del 
argumento subarray del array de 
caracteres al buffer string. 


Añade al buffer la representación 
string del argumento double. 


Añade al buffer la representación 
string del argumento float. 


Añade al buffer la representación 
string del argumento int. 


Añade al buffer la representación 
string del argumento long. 


Añade al buffer la representación 
string del argumento Object. 


Añade al buffer la cadena pasada 
como argumento. 


Devuelve el carácter que ocupa la 
posicición marcadapor el argumento 
indexen la secuencia representada 
por el buffer. 


Método 


Descripción 


StringBuffer delete(int start, int end) 


StringBuffer deleteCharAt(int index) 


void ensureCapacity(int minimum 
Capacity) 


void getChars(int srcBegin, 
intsrcEnd, char[ ] dst, int dstBegin) 


StringBuffer insert(int offset, 
boolean b) 


StringBuffer insert(int offset, char c) 


StringBuffer insert(int offset, 
char[ ] str) 


StringBuffer insert(index, char|[ ] str, 
int offset, int len) 


StringBuffer insert(int offset, double d) 


StringBuffer insert(int offset, float f) 


StringBuffer insert(int offset, int i) 


StringBuffer insert(int offset, long f 


StringBuffer insert(int offset, 
Object obj) 


StringBuffer insert(int offset, 
String str) 


int lengih( ) 


Borra los caracteres en un substring 
de este buffer. 


Borra el caracterdelbuffeque ocupa 
la posicion dada por el argumento, 
acortando el buffer en un carácter. 


Asegura que la capacidad del buffer 
sea al menos igual al mínimo dado 


Los caracteres se copian de este 
bufferstringen elarrayde caracteres 
de destino. 


Inserta la representación string del 
argumento booleano en el buffer 
string. 


Inserta la representación string del 
argumento char en el buffer. 


Inserta la representación stringdel 
array de caracteres del argumento 
en el buffer string. 


Inserta la representación de un sub- 
array del array str del argumento en 
el buffer string. 


Inserta la representación string del 
argumento doubleen elbufferstring. 


Inserta en elbufferla representación 
string del argumento float. 


Inserta en elbufferla representación 
string del segundo argumento. 


Inserta en elbufferla representación 
del argumento long. 


Inserta la representación del argu- 
mento Object en el buffer string. 


Inserta la cadena en el buffer string. 


Devuelve la longitud (en caracteres) 
del buffer. 


Método Descripción 


StringBuffer replace(start, int end, 
String str) 


StringBuffer reverse( ) 


void setCharAt(intindex, char ch) 


void setLenght (int newlengíih) 
String substring(int start) 


String substring(int start, int end) 


String toString( ) 


Reemplaza los caracteres del sub- 
string delbufferstring con los carac- 
teres del string dado. 


Lasecuencia de caracteres delbuffer 
es reemplazado por su inversa. 


El carácter del buffer que ocupa la 
posicióndada por el índicese cambia 
por el marcado en el segundo argu- 
mento. 


Establece la longitud del string. 


Produce una nueva cadena que 
contiene una secuencia de caracte- 
res contenida en el buffer. El sub- 
string empieza en el índice dado. 


Produce una nueva cadena que 
contiene una subsecuencia de 
caracteresactualmentecontenidaen 
el buffer. 


Convierte los datos del buffer a un 
string. 


Ahora, veamos cómo se inicializa un nuevo objeto StringBuffer con una 


cadena: 


public class app 
{ 


public static void main (String[l args) 


I 


StringBuffer sl = new StringBuffero; 
sl.insert (0, "¡Hola desde Java!"); 


System.out.println(sl); 


String-uffers2 = new -tringBuffer (-iH0idesde Java!"); 


System.out.println (s2); 


Además se puede crear un objeto StringBuffer con una longitud específi- 


ca, como sigue: 


public class app 
I 


public static void main(String[] args) 


{ 
stringBuffer si = new StringBuffero; 


sl.insert (0, "¡Hola desde Java!"); 
system.out.println(s1); 


StringBuffer S2 = new StringBuffer ("i-Olalesde Java!"); 
System.out.println(s2); 


StringBuffer s3 = new StringBufferíloO); 
s3.insert (O, "¡Hola desde Java!"); 
system. out .println (s3); 


4 
Este es el resultado del programa: 


C:X>Java app 

¡Hola desde Java! 
¡Hola desde Java! 
¡Hola desde Java! 


Obtención y establecimiento de longitudes 
y capacidades de StringBuffer 


Se puede usar el método length de la clase StringBuffer para buscar las 
longitudes de los objetos en StringBuffer, y se puede usar el método capacity 
para localizar la cantidad de espacio de memoria alocado para ese texto. 
Además, se puede fijar la longitud del texto en un objeto StringBuffer con el 
método setlength, que permite truncar cadenas o extenderlas con caracteres 
nulos (es decir, caracteres cuyos códigos Unicode son 0). 

Esto es un ejemplo que muestra cómo determinar la longitud de una 
cadena, cómo determinar su capacidad (Java normalmente hace que la capaci- 
dad sea 16 caracteres mayor que la longitud, para ahorrar tiempo para futuras 
alocaciones de memoria), y cómo cambiar la longitud de la cadena: 


public class app 
{ 
public static void main (String[] args) 


{ 


StringBuffer sl = new StringBuffer ("iHoladesde Java!"); 


System.out .println("La longitud es m + sl.length( )); 


Syst-.out .println ("La longitud reservada es + 
sl.capacity( )); 


El. sstLength i2000) ; 


System.out .println("La nueva longitud es "4 sl.length( )); 
1 
Esto es lo que el programa muestra al ejecutarlo: 
C:\>java app 
La longitud es 17 


La longitud alocada es 33 
La nueva longitud es 2000 


Establecer caracteres en StringBuffers 


"¡Socorro!" grita el programador novato, "jnecesito cambiar algo de texto 
en mi novela!" "Puede intentarlo con el método setCharAtUle dice. 

Para leer caracteres de un objetoStringBuffer, se pueden usar los métodos 
charAt y getChars, al igual que con los objetos String. Sin embargo, en los 
objetos StringBuffer, también se pueden introducir caracteres individuales 
usando el método setCharAt. 

Esto es un ejemplo en el que se cambia el texto "She had a wild look in her 
eyes". por "She had a mild look in her eyes”. usando setCharAt: 


public class app 
( 


public static void main(String[] args) 
I 
StringBuffer sl = new 
StringBuffer ("Shehad a wild look in her eyes".); 


El. petCharAtii0, "m" } p 


Este es el resultado: 


C:\>java app 
She had a mild look in her eyes 


Añadir e insertar utilizando StringBuffers 


"El método setCharAtno lo hace", dice el programador novato. "Necesito 
alguna forma de editar el texto de los objetos StringBuffercomo una cadena, 
no como caracteres individuales". "De acuerdo", le dice, "use los métodos 
append e insert". 


Se puede usar el método append para añadir cadenas al texto en un objeto 
StringBuffer, y el método insert para insertar texto en un lugar en particular. 
Este es un ejemplo que empieza con "¡Hola"; se le añade "Java!", y luego se 
le inserta "desde" en el medio del texto, usando append e insert: 


public class app 
( 


public static void main(String[] args) 


{ 


StringBuffer si = new StringBuffer ("Hola"); 
sl. .appendi" Jawal")jj 


Syatár. our. printlia( mi); 


Sl.insert(6, "desde )5 


yates. out. .peintla(slh; 


Esto es lo que produce el código: 


C:\>java app 
¡Hola Java! 
¿Holadesde Java! 


Borrar texto en StringBuffers 


Se puede borrar texto en un objeto StringBuffer usando los métodos delete 
y deleteCharAt. 

Por ejemplo, aquí podemos ver cómo se cambia el texto "No tengo un 
buen momento" por "Tengo un buen momento” con delete (al usar este 
método, se especifica el rango de caracteres que se quieren borrar): 


public class app 
( 


public static void main (String[l args) 


( 


StringBuffer sl = new 
StringBuffer ("Notengo un buen momento"); 


s.delete(0, 2); 
System.out .println (SI); 
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Este es el resultado: 


C:i>java app 
tengo un buen momento. 


Reemplazar texto en StringBuffers 


"Estoy escribiendo un editor de texto usando la clase StringBuffer", dice 
el programador novato, "pero hay una cosa que no entiendo, ¿cómo puedo 
reemplazar un texto por otro? ¿Tengo que borrarlo y luego insertar el nuevo?" 
"No", le contesta. "Es fácil, basta con usar el método replace". 

De hecho, ya se ha visto cómo se usa replace; sólo hay que especificar un 
rango de caracteres y el nuevo texto que debería sustituir al rango marcado, 
como sigue: 


public class app 


( 


public static void main(String[] args) 
( 
StringBuffer sl = new StringBuffer (";Hola desde Java!"); 


a. replacs(é, 11, "ajj 


Syatem. out printinisl!; 


Este es el resultado del código anterior: 


C:i>java app 
¡Hola a Java! 


m Operadores, 
condicionales 
y bucles 


En el capítulo anterior, vimos cómo Java gestiona los datos desde un 
punto de vista básico. En este capítulo, empezaremos a trabajar con esos 
datos, como examinar los operadores, condicionales y bucles en Java. 

Almacenar muchos datos en el programa es bueno, siempre y cuando se 
haga algo con ellos. Utilizando operadores, se pueden manipular los datos, 
sumar, restar, multiplicar, dividir y mucho más. Con los condicionales, se 
puede alterar el flujo de un programa evaluando los valores de los datos. Con 
los bucles, se puede iterar sobre todos los datos de un grupo, como un array, 
trabajando con ellos sucesivamente de forma fácil. Estos tres casos son el 
siguiente paso en la potencia de la programación y los discutiremos en este 
capítulo. 


Operadores 


La forma más básica de trabajar con los datos en un programa es hacerlo 
con los operadores de Java. Por ejemplo, supongamos que se ha almacenado un 
valor de 46 en una variable, y el valor 4, en otra. Se pueden multiplicar esos dos 
valores con el operador de multiplicación (*), como se indica en este código: 


public class app 


public static void main(String[] args) 
i 
int operandl = 46, operand2 = 4, product: 


product = operandl i operanda; 


"n * " 


System.out.printlnioperandl + 
E + product) ; 


+ operand2 t 


1 
Este es el resultado del código: 


C:\>java app 
46 * 4 = 184 


¿Qué operadores hay en Java? Esta es la lista: 


e -- (decremento) 

e -(resta) 

e | (No lógico) 

e |= (distinto) 

e % (módulo) 

e %= (asignación del módulo) 
e S«¿ (AND a nivel de bit) 

e && (AND en cortocircuito) 
e &= (asignación de AND) 

. * (multiplicación) 

. *= (asignación del producto) 
e 1(división) 

e /= (asignación de la división) 
e ?: (if-then-else) 

e A (Xor a nivel de bit) 

- a= (asignación de Xor) 

e 1 (OR a nivel de bit) 


e I1(OR en cortocircuito) 


e |= (asignación de OR) 

e 7 (NOT unario a nivel de bit) 

e +(suma) 

e ++ (incremento) 

e +=(asignación de la suma) 

e = (menor que) 

e c<(desplazamiento de bits hacia la izquierda) 

e <c=(asignación del desplazamiento de bits a la izquierda) 

e c=(menor o igual que) 

e =(asignación) 

e -= (asignación de la resta) 

e == (igual a) 

e >(mayor que) 

e >=(mayor o igual que) 

e >>(desplazamiento a la derecha) 

e >>=(asignación del desplazamiento a la derecha) 

e >>> (desplazamiento a la derecha con relleno de ceros) 

e >>>=(asignación del desplazamiento a la derecha con relleno de ceros) 

Se verán todos estos operadores a lo largo de este capítulo. Aquellos que 
tienen sólo un operando se llaman operadores unarios. Los que tienen dos 


operandos, por ejemplo, la suma (a + b), se llaman binarios. Además, hay un 
operador, ?:, que tiene tres operandos: el operador ternario. 


Nota: a lo largo del capítulo, además de estos operadores, veremos la 
clase Math de Jiva, que permite añadir más capacidad matemática a los 
programas, incluyendo la potenciación (a diferencia de otros lenguajes, 
Java rio tiene un opeirador de potenciación), logaritnlos, funizitnes 
trigonlométricals y mucho más. 


Condicionales 


Después de los operadores, el siguiente paso es usar las sentencias condi- 
cionales, también llamadas instrucciones de control de flujo. Se utilizan para 


tomar decisiones basadas en el valor de los datos y dirigir el flujo del progra- 
ma de acuerdo a esos valores. 

Porque, supongamos que queremos informar sobre el tiempo y si está por 
debajo de 80 grados Fahrenheit, visualizar el mensaje "No hace demasiado 
calor.". Esto se puede hacer comprobando la temperatura actual con una 
sentencia f de Java que compara el valor de la variable temperature con 80 y 
que, si el valor es menor que 80, visualiza el mensaje: 


public class app 
I 


public static void main(String[l1 args) 


{ 


int temperature = 73; 


if (temerature < 80) { 
System. ~ut .println(~Nohace demasiado calor."); 


) 


La sentencia If comprueba si su condición (la parte que aparece entre 
paréntesis) es verdadera, que en este caso es temperature < 80. El operador 
relacional <(menor que) se usa para ver si el valor de la variable temperature 
es menor que 80. Dado que esta variable se ha inicializado a 73, la condición 
de la sentencia ifes verdadera, lo que significa que se va a ejecutar el bloque 
de código de la sentencia If. Este es el resultado: 


C:X>Java app 
NO hace demasiado calor. 


Las sentencias ifpueden ser más complejas si se añaden las cláusulas else. 
Deben seguir a la sentencia ify se ejecutan cuando su condición es falsa. Un 
ejemplo: 

public class app 


public static void main (String[1 args) 


( 


int temperature = 73; 


if (temperature e 80) ( 
System.out.println("Nohace demasiado calor."); 


) 


else I 
System.o-t.println(-i-acmucho calor!"); 


1 


Como veremos en este capítulo, hay otras sentencias condicionales. 


Bucles 


Los bucles son fundamentales en la programación y permiten gestionar 
distintas tareas repitiendo la ejecución de cierto código específico. Por ejem- 
plo, puede que quiera gestionar los elementos de un grupo de datos trabajan- 
do con cada uno de ellos en serie, o quizás quiera ejecutar una tarea hasta que 
cierta condición sea verdadera. El bucle básico involucra a la sentenciafor, 
que permite ejecutar un bloque de código usando un índice. Cada vez que se 
pasa por el bucle, el índice tendrá un valor diferente y se puede usar para 
hacer referencia a cada elemento del conjunto de datos. El índice del bucle se 
usa como si fuera un índice de un array. 

A continuación se muestra el formato general del buclefor (observe que la 
sentencia que forma parte del cuerpo del buclefor puede ser compuesta, lo 
que significa que pueden presentarse varias sentencias sencillas encerradas 
entre paréntesis): 


for (expresión—de—inicialización; condición—final;expresión—de—iteración) 


sentencia 


1 


Se puede inicializar un índice en expresión—de- inicialización (de hecho, 
se pueden usar varios índices en un buclefor), proporcionar una condición 
para finalizar el bucle en condición—final y añadir alguna forma de cambiar 
(normalmente incrementando) el índice en expresión—de- iteración. 

Para aclarar todo esto, pongamos un ejemplo. En este caso, usaremos el 
buclefor para acumular los grados de seis estudiantes de un array y calcular 
el grado medio. Así aparece el código (observe que, realmente, se está decla- 
rando e inicializando el índice del bucle a O en la expresión de inicialización 
del buclefor, ya que Java lo permite, al igual que C++): 


public class app 


1 
public static void main (String[] args) 


{ 
double grades[] = {88, 99, 73, 56, 87, 641; 


double sum, average; 
sum = 0; 
for (int loop—index = 0; loop—index < grades.length; loop-index++) 


c 
sum += grades [loop-index]; 


average = sum / grades.length; 


System.out .println("Grado medio = + average); 


) 


Este código recorre todos los grados del array y los va sumando, dejando 
el resultado en la variable sum, que después se divide entre el número total de 
elementos del array para calcular el grado medio. Todos los elementos se 
recorren utilizando un índice que empieza en O y en cada paso se incrementa 
hasta llegar al último elemento del array. Este es el resultado del código: 


C:X>java app 
Grado medio = 77.83333333333333 


Como se puede ver, el bucle for es potente; de hecho es uno de los muchos 
puntos que se tratarán en las secciones siguientes. Ya es hora de empezar a 
usar los operadores, las sentencias condicionales y los bucles. 


Precedencia de operadores 


"Oye", dice el programador novato, "Java está actuando mal otra vez. 
Estaba tratando de sumar 12 más 24 y luego dividir el resultado entre 6. La 
respuesta debería ser 6 y Java devuelve 16". "Probablemente es un problema 
de precedencia de los operadores", le respondemos. "Revisemos el código”. 

Java soporta gran cantidad de operadores y puede haber problemas si se 
utilizan muchos en una sentencia simple. ¿Qué operador se ejecuta primero? 
Por ejemplo, veamos el código del programador novato, en el que intenta 
sumar 12 más 24 y dividir la suma entre 6: 


public class app 
I 


public static void main(String[] args) 
I 
double value; 


value = 12 + 24 / 6; 


System.out.println("El valor = + value); 
Este es el resultado del código: 


C:\>java app 
~l valor = 16.0 


Claramente, hay algo que se ha hecho de distinta forma a la que el pro- 
gramador novato esperaba. De hecho, Java tiene una precedencia de operado- 


res muy clara, lo que quiere decir que si encuentra dos operadores del mismo 
nivel en una sentencia (es decir, no encerrada entre paréntesis), primero 
ejecutará el operador de mayor precedencia. Esto eslo que ocurre aquí; que el 
operador 1 tiene mayor precedencia que el operador +, por lo tanto en la 
expresión anterior, primero se divide 24 entre 6 y el resultado se divide entre 
12 dando 16. 

Para especificar en Java el orden que se quiere, se puede usar paréntesis 
para agrupar las operaciones que se quieren ejecutar primero. Así quedaría el 
ejemplo anterior, en el que se ha puesto entre paréntesis "12 + 24", para 
asegurar que esta operación se ejecuta primero: 


public class app 
( 


public static void main (String[l args) 
double value; 


value = (12 + 24) / 6; 


System.out.println("El valor = + value); 


) 


Este es el resultado del código: 


C:>java app 
~l valor = 6.0 


La tabla 3.1 explica la precedencia de operadores en Java (desde la más 
alta a la más baja). Observe que en el nivel de precedencia más alto, encontra- 
rá (), [ ] (el "operador" array, que se usa para obtener los datos de un índice 
específico en unarray), y . (el operador punto, que se usa para especificar los 
métodos y los miembros de datos de los objetos). Esto significa, por ejemplo, 
que siempre se pueden usar paréntesis para establecer el orden de ejecución 
de las operaciones en las expresiones de Java. 

En este capítulo, veremos todos estos operadores de Java en orden de 
precedencia. Empezaremos por los operadores incremento y decremento: ++ 


y”. 
Incremento y decremento: ++ y ~- 


El zar de la Programación Exacta aparece y dice, "C++tiene un operador 
de incremento y otro de decremento. iJava los soporta?" "Claro", le dice. 
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El operador de incremento ++ suma uno al operando y el operador de 
decremento -- se lo resta. Por ejemplo, si value tiene el valor O, después de 
ejecutar vahe++, tendrá el valor 1. Estos operadores se introdujeron en C 
para incrementar y decrementar valores fácilmente, por ser operaciones muy 
comunes. De hecho, fueron tan populares que el operador de incremento se 
usó en el nombre de C++, indicando que C++ es una versión incremental de 


C. 


Tabla 3.1. Precedencia de operadores. 


NN [] 


++ is s=] 


s j a 


= [operador]= 


Aquí hay un punto importante: ++ y -- pueden ser operadores sufijo (por 
ejemplo, vahe++) o prefijo (++vahe). Cuando se usan como operadores 
sufijo, se ejecutan después del resto de la expresión y cuando se usan como 
operadores prefijo, se ejecutan antes que el resto de la expresión. Esto es algo 
que hay que comprobar. Por ejemplo, veamos el siguiente código: 


En este caso, cuando la sentencia se completa, value2 contendrá el valor 
original de valuel y el valor de valuel se incrementará. He quí un ejemplo de 
cómo funciona: 


public class app 
I 
public static void main(String[] args) 


{ 


intvaluel = 0, value2 = 0; 


System.out.println("valorl 
system.out .printl1nM"valor2 = 


+ valuel); 
+ value2); 


values = valuel+=*; 


System.out.println ("Despues de ejecutar value2 = ++valuel... ); 


System.out.println("valorl = + valuel); 


System.out.println("valor2 = + value2); 


int value3 = 0, values4 = 0; 


cut. printinih: 

cut. printloi“vralori = walue3 

cüt. printini"*elord = 7 è alud 
valuei ++yiluė 


System.out .print1n ("Después de ejecutar value4 = ++value3... ) 
System.out.println("valor3 " + value3); 


ni"valord ¿+ valgedd; 


tem. cut. print 


ByE 
Estos son los resultados: 


C:\>java app 

valorl = 0 

valor2 = 0 

Después de ejecutar value2 = ++valuel... 
valorl = 1 

valor2 = 0 


valor3 = 0 
valor4 0 
Después de ejecutar value! = ++vailue3... 
valor3 = 1 
valor! = 1 


NOT unario: ” y ! 


El operador ~ es el operador unario NOT a nivel de bit y ! es el operador 
unario lógico NOT. El operador 7 cambia todos los bits de los argumentos 
numéricos y el operador ! cambia los valores verdaderos a falsos y viceversa. 
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Esto es un ejemplo en el que se cambian todos los bits del mayor valor 
positivo que puede ser almacenado en un dato de tipo short, para obtener el 
valor más negativo posible de un short, y además se cambia un valor booleano 
de verdadero a falso: 


public class app 
I 


public static void main(String[l1 args) 


{ 
short shortl = 32767; 


boolean booleanl = true; 

system.out.println("El valor mbs negativo de un short = Tg —shortl); 
sy-tem.out.println(-!verdadero =" + Ibooleanl); 

| 

Este es el resultado: 

C:X>java app 


El valor más negativo de un short = -32768 
Iverdadero = false 


Si se inicializa intl a 0 y luego se cambian sus bits con el operador ” a 
1111111111111111 en binario, Java habría visualizado el resultado -1, por- 
que usa la notación de complemento a dos para los números negativos. Esto 
significa que el bit que ocupa el primer lugar en los números negativos es 1 y 
O para los positivos. 


” m y 


Multiplicación y división: * y / 


El zar de la Programación Exacta dice, "Espero que Java tenga operadores 
de multiplicación y división, como C++". "Claro, " le dice. 

En Java, se utiliza * para multiplicar y / para dividir valores. Veamos un 
ejemplo en el que se usa úl y / con valores double, y luego se hace lo mismo 
con valores enteros. Se ejecuta la multiplicación y división con valores ente- 
ros para mostrar que, cuando se usan enteros, la parte fraccionaria de los 


resultados matemáticos se truncan. Por lo tanto, si se quiere ejecutar una 
operación de división y mantener la precisión, probablemente no se deberían 
usar enteros. Este es el código: 


public class app 


public static void main(String[l1 args) 


{ 
double doublel = 4, double2 = 6, double3 = 5, doubleResult; 


* 


doubleResult = doublel double2 / double3; 


int intl = 4, int2 = 6, int3 = 5, intResult; 


* 


intResult = intl int2 / int3; 


* " 


Systern.out.println("Con enteros, 4 6/5= + intResult); 
1 
Este es el resultado: 


C:X>java app 
4x*6/5=4.8 
Con enteros, 4* 6 / 5= 4 


Módulo: % 


Se usa el operador módulo (%) para devolver el resto de una operación de 
división. Por ejemplo, 1013 es igual a 3 con un resto de 1. Observe que el 
operador módulo es especialmente útil cuando se hace conversión entre ba- 
ses, porque se puede usar con la base a la que se está convirtiendo. Para ver 
cómo funciona, eche un vistazo a la sección "Bucle for", más adelante. En 
ella hay un ejemplo completo. 


Suma y resta: + y ~ 


"El operador multiplicación es un asterisco y el de la división es una barra 
inclinada”, dice el programador novato, "pero esos no son los signos que se 
aprenden en el colegio. ¿Qué utiliza Java para los signos más y menos?" "Los 
símbolos usuales", le contestamos. 


Los operadores numéricos más antiguos son + y -, que se usan para la 
suma y la resta, respectivamente. Por ejemplo: 


public class app 
( 


public static void main (String[] args) 


( 


int operandl = 5, operand2 = 4, sum, diff; 


sum = operandl + operandl; 
diff = operandl ” operand2; 


System.out .println(operandl + "+ "+ operand2 + " = " + sum); 


Systern.out.println(operandl + = + operand2 + 5 + diff); 
1 


Estos son los resultados: 


Operadores de desplazamiento: >>, >>> y << 
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Se usan los operadores de desplazamiento para desplazar, hacia la izquier- 
da o derecha del operando situado en el lado izquierdo, el número de bits 
indicado por el operando situado en el lado derecho. Hay tres operadores de 
desplazamiento: hacia la derecha (>>), hacia la derecha sin signo (>>>) y 
hacia la izquierda (e < )Así se usan estos operadores: 


nuevo—valor = valor << número—de—lugares; 
nuevo—valor valor >> número—de—lugares; 
nuevo—valor valor >>> número—de—lugares; 


Por ejemplo, 16 >>2 desplaza 2 bits hacia la derecha del número 16, que 
es lo mismo que dividir entre 4; por lo tanto, 16 >>2 es igual a 4. Normal- 
mente, se usan los operadores de desplazamiento para empaquetar valores 
binarios en un int o long como campos, porque se puede sumar un número al 
into long y luego desplazarlo haeia la izquierda para hacerle sitio al siguiente 
campo de datos. 

Es importante que sepa que el operador >>respeta el signo de su operando 
y dado que un valor negativo significa que el bit de más a la izquierda es 1, el 
desplazamiento de un número negativo hacia la derecha introduce un nuevo 1 
en su izquierda. Así, cambiar 1111111111111100, que es -4 como un short, 
devuelve 11/11111111111110, que es -2. Además, cambiar —1, que es 


1111111111111111,da 1111111111111111,quecontinúasiendo-1.Sireal- 
mente quiere trabajar con los bits actuales de un número cuando se los 
desplaza a la derecha y no tiene uno añadido a la izquierda cuando se despla- 
zan a la izquierda números negativos, use el operador de desplazamiento sin 
signo hacia la derecha (>>>). Éste introduce un cero a la izquierda, si el 
número es positivo o negativo. 

Veamos un ejemplo donde interviene el operador de desplazamiento: 


public class app 


public static void main (String[l args) 
1 


int value = 16, negValue = -1; 

«“ystem.out.println (value+ " << 2 = Mo (value << 2)); 
System.out.println (value + ">s 2 = (value >> 2)); 
System.out.println(negValue + ">> 2=°n 4 (negValue >> 2)); 
“ystem.out.println (negValue + =" >>> 22 = ME (negValue >>> 22)); 


1 


Este es el resultado: 


Operadores de relación: >, >=, <, <=, ==y != 


El Gran Jefe (GJ) aparece y dice, "Casi hemos gastado el presupuesto y 
hay que asegurarse de que no lo sobrepasamos”. "Hmm", le dice, "parece que 
es un trabajo para el operador de relación menor que. Por cierto, sobre lo de 
mi ascenso...". "Olvídelo", dice el GJ. 


Use los operadores relacionales para crear condiciones lógicas que puedan 
ser evaluadas con sentencias condicionales como If. Por ejemplo, veamos lo 


que deberíamos evaluar para asegurarnos que el presupuesto es mayor que 
cero utilizando la sentencia İf: 


public class app 
I 
public static void main (String[] args) 
1 
int budget = 1; 
if (budget < 0) ( 
System.out .println ("Uh  oh."); 
1 
else I 


Sfyaten.out.preintin]*Todavría #s polvente.™ h}; 


Este es el resultado: 


C:\>java app 
Todavía es solvente. 


A continuación se muestra una lista de los operadores relacionales; estos 
operadores devolverán verdadero si sus operandos cumplen las descripciones 
dadas: 


e >(mayor que; por ejemplo, operandol >operando2 devuelve verdadero 
si el operando 1 es mayor que el operando 2) 


e >= (mayor o igual que) 
e <(menor que) 

e <= (menor o igual que) 
e == (igual a) 


e |= (distinto) 


Los operadores relacionales se pueden combinar con operadores lógicos 
(para más detalles, ver el siguiente punto). 


Operadores lógicos a nivel de bit AND, Xor y OR: 


"Bocorro!" dice el programador novato, "necesito saber si el bit número 3 
de un entero está puesto a 1. ¿Hay alguna forma fácil de hacerlo?" "Claro", le 
dice, "puede usar un operador a nivel de bit". 

Los operadores a nivel de bit permiten examinar cada uno de los bits de 
los valores. Por ejemplo, cuando se usa el operador a nivel de bit & con dos 


operandos, se realiza la operación lógica AND con cada bit de un operando y 
su correspondiente en el otro. Si ambos bits son 1, un uno aparece en ese 
lugar en el resultado; de lo contrario, será un cero. Por ejemplo, se puede 
hacer la prueba del programador novato de si el tercer bit de un valor está a 1 
haciendo el AND lógico con un número para el que se sabe que el tercer bit es 
1. Si el resultado de la operación AND no es cero, el tercer bit del valor 
original era 1. Aquí se muestra cómo sería el código: 


public class app 
I 


public static void main (String[] args) 


{ 


int value = 12; 
int bit3setting = value & 1 << 3; 


if (bit3setting!= 0) { 
System.out.println("Bit3 está activo."); 

1 

else ( 
System.out.println("Bit 3 no está activo."); 


Este es el resultado: 


C:X>Java app 
Bit 3 está activo. 


Los operadores a nivel de bit se pueden encontrar en la tabla 3.2. En pocas 
palabras, así es cómo funcionan: El operador OR {I} devuelve O cuando 
ambos bits son O y devuelve 1 en caso contrario. El operador AND (8) 
devuelve 1 cuando ambos bits son 1 y devuelve O en caso contrario. Final- 
mente, el operador Xor (", llamado OR exclusivo) devuelve 1 cuando un bit 
es 0 y el otro es 1 y devuelve 0 en caso contrario. 

Cuando los operadores €, y | operan con valores booleanos verdaderol 
falso, se consideran operadores lógicos a nivel de bit. Los operadores lógicos 
a nivel de bit funcionan igual que los operadores a nivel de bit (sustituyen 
falso por O y verdadero por 1), como se puede ver en la tabla 3.3. 

En pocas palabras, así funcionan los operadores lógicos a nivel de bit: el 
operador OR (| devuelve falso cuando ambos operandos son falsos y devuel- 
ve verdadero en caso contrario. El operador AND (8) devuelve verdadero 
cuando ambos operandos son verdaderos y devuelve falso en caso contrario. 
El operador Xor (") devuelve verdadero cuando un operando es falso y uno es 
verdadero, y devuelve falso en caso contrario. 


Tabla 32 Los operadores a nivel de bit. 


E y ly(0) xy (W) x * y (Xor] 
ü ü ü 0 o 
1 o 1 o 1 
(E 1 1 0 i 
1 1 1 1 o 


Falso Falso Falso Falso Falso 


Verdadero Falso Verdadero Falso Verdadero 
Falso Verdadero Verdadero Falso Verdadero 
Verdadero Verdadero Verdadero Verdadero falso 


Este es un ejemplo en el que se han puesto dos condiciones lógicas juntas, 
visualizando un mensaje en el caso de que cualquiera de ellas sea verdad, 
usando el operador |: 


public class app 
I 
public static void main(String[] args) 
I 
int budget = 1; 
boolean fired = falce; 


if (budget < 0 | fired == t ~ eh 


Syctem.out.println("Uhoh.., ; 
1 
elce ( 
Syctem.out.println("“-odavíaes solvente.") ; 


1 
1 
Este es el resultado: 


C:X>Java app 
~odavíæs solvente. 


En el siguiente ejemplo, insisto en que la temperatura está entre 60 y 90 
grados, usando el operador lógico a nivel de bit &, antes de visualizar un 
mensaje: 


public class app 


{ 
public static void main (String[l args) 


I 


int temperature = 70; 


if (tanperature < 90 & temperature > 60) { 
System.out .println ("Podemos ir de merienda.") ; 


1 
1 
Este es el resultado: 


C:\>java app 
podemos ir de merienda 


Como se puede ver, los operadores lógicos a nivel de bit pueden ser muy 
útiles. Java además incluye dos operadores lógicos: && y ll. Veámoslos a 
continuación. 


&& y Illógicos 


Los dos operadores lógicos que generalmente se usan en expresiones son 
AND (88) y OR (11). La tabla 3.4 muestra cómo funcionan estos operadores. 

El operador OR (| devuelve falso cuando ambos operandos son falsos y 
devuelve verdadero en caso contrario. El operador AND (&&) devuelve 
verdadero cuando ambos operandos son verdaderos y devuelve falso en caso 
contrario. Estos operadores se usan para enlazar cláusulas lógicas, se usa 
AND cuando se quiere que ambas cláusulas sean verdad y OR cuando sólo se 
necesita que una de las dos sea verdadera. 

Este es un ejemplo del punto anterior, en el que se usa «4: 


public class app 
{ 


public static void main (String[l args) 
{ 
int temperature = 70; 
if (temperature < 90 && temperature > 60) I 
System.out.println("Podemos ir de merienda."); 
4 
1 
El resultado es: 


C:X>Java app 
Podemos ir de merienda. 


MRE 


Los operadores && y l tienen además otra propiedad interesante: son 
operadores cortocircuito, lo que quiere decir que si pueden determinar todo lo 
que necesitan saber evaluando el operando de la izquierda, no evaluarán el 
operando derecho. Esto es muy útil en casos como el que sigue, en el que 
estamos comprobando si un valor tiene O y si u inverso es menor que 1000. Si 
el valor es O, la segunda parte de la expresión, en la que se calcula su inverso, 
no se ejecuta. De esta forma, se evita un error de desbordamiento al intentar 
dividir entre cero. 


Tabla 3.4. Los operadores lógicos. 


x 58 y (1) 
Falso Falso Falso Falso 
Verdadero Falso Verdadero Falso 
Falso Verdadero Verdadero Falso 

| Verdadero Verdadero Verdadero Verdadero 


Este es el código: 


public class app 
I 
public static void main(String[] args) 


{ 


double value = 0; 


if (value l= 0 && 1 / value < 1000) { 
System.out.println("Elvalor no es demasiado pequeño."); 

1 

else ( 
System.out.println("Elvalor es demasiado pequeño."); 


1 


Este es el resultado: 


C:X>java app 
~l valor es demasiado pequeso 


Los operadores lógicos se diferencian de los operadores lógicos a nivel de 
bit en que los primeros son operadores cortocircuito. Para ver cómo funcio- 
nan, echemos un vistazo al código siguiente, en el que la asignación de la 
sentencia $se ejecuta cuando se usa el operador & pero no cuando se usa el 
operador cortocircuito &&: 


public class app 
{ 
public static void mainíString[] args) 


I 
double intl = 0, int2 = 1, int3 = 1; 


if (intl i= 0 & (int2 = 2) = 1) { 1 
System.out.println("int2 = "+ int2); 
if (intl != 0 & (int3 = 2) == 1) ( 1 
System.out.println("int3 = " + int3); 


4 
Este es el resultado: 


C:i>java app 
int2 = 2.0 
int3 = 1.0 


El operador /f-Then-Else:”: 


"De acuerdo", dice el programador novato (PN), "soy un experto en opera- 
dores. Estoy preparado para las sentencias condicionales de Java". "No tan 
rápido", le dice. "¿Qué hay sobre el operador condicional ternario?" "¿El 
qué?" pregunta PN. 

Hay un operador Java que funciona como una sentencia if-else, el opera- 
dor ternario (?:). Este operador se llama operador ternario porque involucra 
tres operandos, una condición y dos valores: 


valor = condición ? valorl : valora: 


Si la condición es verdadera, el operador ?: devuelve valorl y, en caso 
contrario devuelve valor2. De esta forma, la sentencia precedente funciona 
como la siguiente sentencia if: 


if (condición) I 
value = valorl; 


} 
else { 
value = valora; 


1 


Veamos un ejemplo en el que un entero entre O y 15 se convierte a 
hexadecimal usando el operador ?. Este operador es perfecto para esto, 
porque se puede usar para devolver una cadena construida a partir de un 
valor, si el valor es menor que 10 o un dígito si el valor es mayor o igual que 
10, como sigue: 


public class app 


( 
public static void main(String[l args) 


I 
int value = 15; 
String digit, chars [] = ("a"; "prg TE Ny mal” "e", SETTI 
Digit = valuo < 10 ? String valueo0f (value) : charstvalue - 101; 


System.out.println(value + ' = Ox" + digit); 


) 


Este es el resultado: 


C:X>java app 
15 = Oxf 


Operadores de asignación: =y [operador]= 


La mayor parte de los operadores básicos son operadores de asignación 
(ya hemos usado estos operadores en el libro). El operador =se puede utilizar 
para asignar a una variable un valor literal o el valor de otra variable, como 
sigue: 


public class app 


I 
public static void main(String[l args) 


{ 
int value = 12; 


System.out.println("El valor = + value); 


1 
Este es el resultado: 


C:\>java app 

El valor = 12 

Como en C++, se pueden ejecutar múltiples asignaciones en la misma 
sentencia (esto funciona porque el operador asignación, devuelve el valor 


asignado): 


public class app 


( 
public static void main(String[l1 args) 


( 
int valuel, value2, value3; 


valusl = valusi = value) = 13; 
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Este es el resultado: 


Además, como en C++, se pueden combinar muchos operadores con el 
operador de asignación (=). Por ejemplo, += es el operador de asignación de 
la suma, que significa que value += 2 es una forma corta de value = value + 2. 
Esto es un ejemplo que utiliza el operador de asignación de la multiplicación: 


public class app 
I 


public static void main(String[l args) 
{ 

int value = 10: 

value *= 2; 


System.out.println("value * 2 = + value); 


4 
Este es el resultado: 


C: \>java app 
value * 2 = 20 


Hay bastantes combinaciones de operadores de asignación. Esta es la lista: 
e %= (asignación de módulo) 

e &= (asignación a nivel de bit de AND) 

e *= (asignación de multiplicación) 

e /= (asignación de división) 

e "= (asignación a nivel de bit de Xor) 

e |= (asignación a nivel de bit de OR) 

e += (asignación de suma) 


e <<= (asignación de desplazamiento a la izquierda) 
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e <=(menor o igual que) 
e -=(asignación de resta) 
e >>= (asignación de desplazamiento a la derecha) 


e >>>= (asignación de desplazamiento a la derecha con relleno de ceros) 


Esto completa la lista de los operadores de Java, pero hay una forma más 
popular de gestionar matemáticas en Java, la clase Math. Esta clase es parte 
del paquete java.lang (que el compilador Java importa por defecto). Echare- 
mos un vistazo a esta clase en la siguiente sección. 


Utilización de la clase Math 


"Oye", dice el programador novato (PN)",quiero elevar3 a la potencia 4, 
pero no hay ningún operador de Java para la potenciación”. "Se puede usar el 
método pow de la clase Math", le dice. "Y de esta forma, 3 elevado a la 
potencia 4 es 81". "La crearé cuando Java me lo pida, " dice PN. 

Se puede usar la clase java.lang.Math para ejecutar muchas operaciones 
matemáticas. Por ejemplo, asíse resuelve el problema del programador nova- 
to usando el método Math.pow: 


public class app 
I 
public static void main (String[l args) 
I 
Syritem.out .println (.3 x3x3x3="+ ~ath.por (3, 4))s 
1 
1 


Este es el resultado: 


C:\>java app 
3 x 3 ~ 3 =8130 


Las constantes y métodos de la clase son: 


e double E: El número 'e' (2.7182818284590452354) 
e double PI: La constante pi (3.14159265358979323846) 
e double sin(doublea): Seno 


e double cos(double a): Coseno 


double tan(double a): Tangente 

double asin(double a): Arcoseno 

double acos(doublea): Arcocoseno 

double atan(double a): Arcotangente 

double atan2(double a): Arcotangente (versión 2 del operando) 
double exp(double a): Eleva el número 'e' a la potencia 'a' 
double logí(double a): Logaritmo del valor 'a' 

double sqrt(double a): Raíz cuadrada del valor 'a' 

double pow(double a, double b): Elevar el valor 'a' a la potencia 'b' 
double cell(double a): Método ceilling 

double floor(double a): Métodofloor 

double rint(doubl1e a): Entero aleatorio 

int round(double a): Redondea un double 

long round(float a): Redondea unfloat 

double random( ): Número aleatorio 

int abs(inta): Valor absoluto de un entero 

long abs(1 ong a): Valor absoluto de un long 

float abs(float a): Valor absoluto de unfloat 

double absí(double a): Valor absoluto de un double 

int min(int a, int b): Mínimo de los dos enteros 

long min(long a, long b): Mínimo de dos long 

float min(float a,float b): Mínimo de dosfloat 

double min(double a, double b): Mínimo de dos double 
int max(int a, int b): Máximo de dos enteros 

long max(long a, long b): Máximo de dos long 

float max(float a,float b): Máximo de dosfloat 

double max(double a, double b): Máximo de dos double 


Comparación de cadenas 


Cuando se está trabajando con la clase String, hay algunos métodos que se 
pueden usar como operadores. Por ejemplo, los métodos equals, equalslgnore- 
Case y compareTo, como sigue: 


e sl. .equals(s2): Verdadero si sl es igual a s2. 


e sl.equalsIgnoreCase (s2): Verdadero si sl es igual a s2 (ignorando las 
mayúsculas y minúsculas). 


s1.compareTo(s2): Devuelve un valor menor que cero si s1<s2, cero si 
sl es igual a s2o un valor mayor que cero si sl > s2. 


He aquí un ejemplo en el que se utilizan todos los métodos: 


public class app 
i 
public static void main(String[] args) 
{ 
String sl = "abc"; 
String s2 = "abc"; 
String S3 = ABC}; 
String s4 = "bcada"; 
if (sl.equals(s2)) ( 


System.out.println("sl== s2"); 
> 
else { 

System.out.println("sl != s2"); 


1 


if (slequalsIgnoreCase(s3) { 


System.out.println("sl == s3 al ignorar las mayúsculas"); 
1 
else { 

System.out.println("sl != s3 al ignorar las mayúsculas"); 


Este es el resultado del código: 


C:\>java app 


S1 == S2 
sl == s3 al ignorar las mayúsculas 
sl c S2 


La sentencia if 


"Hmm", dice el programador novato (PN), "quiero escribir una rutina en 
Java que calcule el valor absoluto y no sé cómo hacerlo". "Supongo que 
nunca ha oído hablar del método Abs de la clase Math", le responde. "¿El 
qué?" pregunta PN. 

Cuando se quiere controlar el flujo del código, es el momento de usar las 
sentencias condicionales de Java, como la sentencia İf. Este es el formato 
general de la sentencia if 


if (condición) sentencial: 
else sentencia2; 


Observe que tanto sentencial como sentencia2 pueden ser compuestas, es 
decir, cierto número de sentencias encerradas entre llaves. 

Una forma de obtener el valor absoluto, como el programador novato 
estaba tratando de hacer, es empezar comprobando si el valor es mayor que 
cero y, sies así, visualizar el resultado tal cual. Aquí, se puede ver cómo se 
haría esa evaluación con una sentencia If: 


public class app 


( 
public static void main(String[] args) 


I 


int value = 10; 


if (value > 0) 
System.out.println("Abs(" + value + ") = " + value); 


Este es el resultado: 


Observe que en este caso, la sentencia que se ejecuta si la condición de la 
sentencia ifes verdadera es simple, pero también se pueden ejecutar múlti- 


ples sentencias haciendo que formen parte de un conjunto de sentencias en un 
bloque de código, como sigue: 


public class app 
I 
public static void main(String[l args) 


{ 


int value = 10; 


if(value > 0) { 
“ystem.out .println(--húmero era positivo."); 


System.-ut.println(-Abs (+ value + "1 = " + value); 


Este es el resultado: 


C:X>java app 
El número era positivo 
Abs (10) = 10 


La sentencia else 


En el ejemplo del valor absoluto, la sentencia f sólo visualiza un valor 
absoluto si el valor ya es positivo. 

Sin embargo, se puede extender esa sentencia lf añadiendo una cláusula 
else, que se ejecuta si la condición de la sentencia ifes falsa. Así se haría en 
el código (observe que se pueden gestionar tanto números positivos como 
negativos): 


public class app 
1 


public static void main(String[l1 args) 
I 


int value = -10: 


if(value > 0) ( 


System.out.println('Ab-= ("+ value + ") = " + value); 
4 
else ( " 
SyStem.out.println("Abs(" + valuo + "1 = + —-value); 


1 
1 


Este es el resultado del código: 


Ifanidados 


También se pueden tener sentencias Sanidadas una dentro de otra (estoes, 
definirlas dentro de otras sentencias iJ. Esto es un ejemplo que muestra cómo 
funciona la técnica: 


public class app 
public static void main (String[] args) 


t 
double value = 2; 


if (value != 0) t 
if (value > 0) 
System.out.println("El resultado = "+ (1/ value)); 
else 
System.out.println("Elresultado = "+ (-1/ value)); 


Este es el resultado del código: 


C:X>Java app 
El resultado = 0.5 


Escalas if-else 


Es posible crear una secuencia entera de sentencias if-else, que se conoce 
como escala 1f-else. A continuación veremos un ejemplo en el que se ve cómo 
funciona (en este caso, se evalúa el valor de una variable tipo string hasta que 
se encuentra el día de la semana): 


public class app 

{ 
public static void main(String[] args) 
I 


String day = "miércoles"; 


if(day == "lunes") 

System.out.println("Es lunes."); 
else if (day == "martes") 
System.out.println("Esmartes."); 
else if (day == "miércoles") 
System.out.println("Esmiércoles.”"); 
else if (day == "jueves") 
System.out.println("Esjueves."); 
else if (day == "viernes") 
System.out.println("Es viernes."); 
else if (day == "sábado") 


System.out.println("Ec sábado."); 
else if (day == "domingo") 
System.out.println("Ec domingo."); 


) 


Este es el resultado del código: 


C:>java app 
Es miércoles. 


Observe que aunque se pueden crear escalas if-else de esta forma, Java 
incluye, para situaciones como esta, la sentencia switch. Veremos esta sen- 
tencia en el siguiente apartado. 


La sentencia switch 


"Vaya", dice el programador novato (PN), "estoy harto de escribir escalas 
if-else, ya llevo cinco páginas de programa". "¿Y si intenta utilizar la senten- 
cia switch?" le pregunta. "¿Qué es eso?" pregunta PN. 

La sentencia switches la sentencia de múltiples selecciones de Java; tiene 
la misma funcionalidad que la escala if-else (ver la sección anterior) pero de 
una forma mucho más fácil. En general, esta es la expresión de la sentencia 


switch: 


switch (expresión) ( 
Case valorl : 
sentencial; 
[break; 1 
case valor2: 
sentencia2 ; 
[break; 1 
case valor3: 
sentencia3; 
[break; 1 


default: 
sentenciagor—defecto; 


1 


En este caso, el valor de la expresión, que debe ser de tipo byte, char, 
short o int, se compara con los distintos valores de las sentencias case: 
valorl, valor2, y así sucesivamente. Si la expresión coincide con una de las 
sentencias case, se ejecuta el código asociado con esa sentencia case: senten- 
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cial, sentencia2, etc. Si la ejecución llega a una sentencia break, la sentencia 
switch termina. 

Esto es un ejemplo en el que se visualiza el día de la semana basándose en 
un valor numérico y utilizando la sentencia switch: 


public class app 
{ 


public static void main (String[] args) 


{ 
int day = 3; 


switch iday) { 
case 0: 
System.out.println("Es domingo."); 
break; 
case 1: 
System.out.println("Es lunes."); 


System.out.println("Es martes."); 


Case 3: 
System.out.println("Ec miércoles.”"); 
break; 

Case 4: 
System.out.println("Ecjueves."); 
break; 

Case 5: 
System.out.println("Es viernes."); 
break; 

default: 

System.out.println("Debe ser sábado."); 


Este es el resultado: 


C:X>java app 
ES miércoles 


También se pueden anidar sentencias switch. Observe que si no se especi- 
fica la sentencia break al final de la sentencia case, la ejecución continuará 
con el código del siguiente case. Algunas veces, esto es útil, ya que se quiere 
ejecutar el mismo código para varios valores: 


public class app 
( 


public static void main (String[] args) 
I 


int temperature = 68; 


case 60: 

case 61: 

case 62: 

case 63: 

case 64: 
System.o-t.println(-Demasiadbrío."); 
break; 

case 65: 

case 66: 

case 67: 

case 68: 

case 69: 
Syctem.out.println("Frío."); 
break; 

case 70: 

case 71: 

case 72: 

case 73: 

case 74: 

case 75: 
System.out.println("Templado."); 
break; 

default: 
System.out.println ("Probablemente demasiado calor."); 


1 
Este es el resultado del código: 


C:i>java app 
Frío. 


Bucle while 


"Bien", dice el programador novato, "tengo problemas otra vez. El gran 
jefe quiere que haga un programa comercial que calcule factoriales y, jni 
siquiera sé lo que es un factorial!" "Bien", le dice, "seis factorial, que se 
escribe como '6/”,es igual a6x5x4x3x2x 1. Y puede escribir su 
programa con un bucle while". 

El cuerpo de un bucle while (puede ser una sentencia compuesta por un 
grupo de sentencias simples encerradas entre llaves) se ejecuta mientras una 
condición lógica sea verdadera. Este es el formato general del bucle while: 


while (condición) 
sentencia 


Observe que si la condición no es verdadera, el cuerpo del bucle no se 
ejecutaría ni una vez. A continuación hay un ejemplo con el bucle while; en 


este caso, se visualiza un valor, se le va restando 1 y después se visualiza el 
resultado siempre y cuando sea positivo. Cuando el valor llega a 0, el bucle 
while se para porque la condición (value > 0) es falsa: 


public class app 
I 


public static void main(String[1 args) 


{ 


int value = 10; 


while (value > 0) C 
Syetem.out.println("Valor actual = Mvg value-); 


1 
1 
Esto es lo que el bucle while devuelve: 


C:\JavaBB\Test>java app 
Valor actual = 10 

Valor actual = 
Valor actual = 
Valor actual = 
valor actual = 


Ko) 


Valor actual = 
Valor actual = 
Valor actual = 
Valor actual = 
Valor actual = 


ENU RUOAN 


A continuación tenemos otro bucle while en el que se resuelve el problema 
del programador novato y se crea un programa que calcula factoriales: 


public class app 
{ 


public static void main (String[] args) 
T 


int value = 6, factorial = 1, temp; 
temp = value; //copia temporal. 


while (temp » 0) ( 
factorial *= + 


System.out.println (value + "! = + factorial); 
1 
Así es como el programa calcula el factorial de 6: 


jara app 
D! 230 


A continuación, hay un ejemplo más avanzado. En este caso, se convierte 
un número a hexadecimal con el operador módulo. Como los dígitos van en 
orden inverso, se usa el bucle while para ponerlos en una pila de Java, que se 
verá cuando discutamos las colecciones de clases. Después de poner los 
dígitos en la pila, se les pasa por otro bucle while para cambiar el orden y 
producir el objeto StringBuffer que se visualiza: 


import Java.util.*; 


public class app 
t 


public static void main (String[l args) 


{ 
int value = 32, temp = value; 
StringBuffer sb = new StringBuffero; 
Stack st = new Stack (); 


while (te- > 0) ( 
st .push (String.valueof (temp % 16)); 
temp >>>= 4; 


while (!st.emptyO) ( 
sb.append (new String((String) st .popo0 )); 
1 


System.out.println("La conversión de + value + es Ox" + sb); 


Esta es la salida del programa: 


La conversión de 32 es 0x20 

Aquí hay algo que puede ser útil: como en Java, las sentencias null son 
válidas, un bucle while no tiene por qué tener un cuerpo. A continuación 
vemos un ejemplo en el que se muestra una forma cruda de calcular la raíz 
cuadrada de un entero (observe que todo lo que se hace tiene lugar en la parte 
de la condición del bucle): 


public class app 
( 


public static void main (String[] args) 
I 

int target = 144, sqrt = 1; 

while (++sgrt * sqrt != target) 5 


Syctem.out.println("sqrt ("+ target + ") = + sqrt): 


Este es el resultado: 


c:X>JavaaPP 
sqrt (144) = 12 


Otro tipo de bucle while es el bucle do-while, que se tratará en el siguiente 
apartado. 


Bucle do-while 


El zar de la Programación Exacta dice, "Entonces, en Java hay un bucle 
while. En C++, tenemos un bucle while y un bucle do-while". "¡Anda!" 
contesta. "En Java, también tenemos ambos bucles". 

El bucle do-while es como un bucle while, salvo en que la condición es 
evaluada al final del bucle, no al comienzo. Este es el formato del bucle do- 
while (tenga en cuenta que la sentencia puede estar compuesta por un número 
de otras sencillas encerradas entre llaves): 


do 
sentencia 
while (condición); 


La principal razón para usar do-while en vez de while es que se necesite 
que el cuerpo del bucle se ejecute al menos una vez. Por ejemplo, este es un 
caso en el que el valor que se está evaluando no está disponible para el test 
hasta el final del bucle: 


public class app 
{ 


public static void main(String[] args) 


{ 


int valuesil = 11, 2, 3, 0, $), test, index = 0; 


do C 
test = 5 * values[index++1; 
1 while (test «< 15); 


1 


Por otro lado, hay ocasiones en las que se debería usar un bucle while en 
lugar de do-while, cuando el cuerpo del bucle no se debería ejecutar ni una 
vez si la condición no es verdadera. Por ejemplo, echemos un vistazo al 
siguiente código en el que un bucle do-while evalúa el inverso de un valor 
pero sólo puede probarlo si el valor es distinto de cero al final del bucle: 
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public class app 
t 
public static void main(String[l1 args) 
1 
double value = 0 


do Í 
System. out .príntln ("El recíproco = "+ 1 / value); 
} while (value > O); 


) 


En este caso, es mucho mejor utilizar un bucle while: 


public class app 


( 
public static void main (String[] args) 
I 


double value = 0; 


while (value > O) { 
System.out.println("El recíproco = " + 1 / value); 


1 


Bucle for 


168 


El programador novato regresa y dice, "Me gustan los bucles while, pero 
cuando se gestionan arrays no son los más fáciles de utilizar, realmente 
necesito un índice numérico. ¿Existe algo así?" "Claro", le dice, "pruebe el 
buclefor". 

El buclefor de Java es una buena elección cuando se quiere usar un índice 
numérico que se incremente o decremente automáticamente cada vez que se 
pase por el bucle, como ocurre cuando se está trabajando con un array. En 
general, este es el formato del buclefor (observe que la sentencia puede ser 
compuesta, incluyendo varias sentencias simples entre llaves): 


for (expresión—de—inicialización;¿condición—final;expresión-iterativa) 


sentencia 
> 


Se puede inicializar el índice del bucle en la expresión—de- inicialización 
(de hecho, se pueden usar múltiples índices en un bucle for), proporcionar 
una condición para terminar el bucle cuando dicha condición sea falsa, en 
condición- final, y dar alguna forma para cambiar, generalmente 
incrementando, el índice en expresión—iterativa. 


Esto es un ejemplo en el que se pone a funcionar el buclefor (observe que 
el bucle se empieza con el índice a 1 y se termina cuando es mayor que 10, es 
decir, el cuerpo del bucle se ejecuta exactamente 10 veces): 


public class app 
ES 
public static void main(String[] args) 


{ 


int loop—index; 


for (loop—index = 1; loop—index a=- loop-index++) { 
System. out .println ("Esta es la iteración número " 
+ loop—index) 5 
1 
> 
1 


Este es el resultado: 


C:\>java app 


Esta es la iteración número 1 
Esta es la iteración número 2 
Esta es la iteración número 3 
Esta es la iteración número 4 
Esta es la iteración número 5 
Esta es la iteración número 6 
Esta es la iteración número 7 
Esta es la iteración número 8 
Esta es la iteración número 9 
Esta es la iteración número 10 


Este es un ejemplo que se vio al principio del capítulo; éste calcula el 
grado medio de un estudiante después de recorrer todos los grados e irlos 
sumando (observe que se está declarando e inicializando el índice a O en la 
expresión de inicialización): 


public class app 
{ 
public static void main(String[l args) 
{ 
double grades[l = {88, 99, 73, 56, 87, 64); 
double sum, average; 


for (int loop—index = 0; loop—index < grades.length; 
loop-index++) C 
sum += gradesiloop-indexl; 


average = sum / grades.length; 


System.out.println("Grado medio = " + average); 


Este es el resultado del código: 


C:X>Java app 
Grado medio = 77.83333333333333 


Cuando se declara una variable del bucle (como loop—index en este ejem- 
plo), el alcance de esa variable está limitado al cuerpo del bucle for (el 
alcance de una variable es la parte del programa en la que se puede acceder a 
ella, como veremos en el siguiente capítulo). 

Observe que se pueden usar expresiones muy generales en un bucle for. 
En un bucle for, Java permite separar expresiones con una coma, como se 
muestra en el siguiente ejemplo en el que se utilizan dos índices: 


public class app 
( 


public static void main(String[l args) 
for (int loop—index = 0, doubled = 0, loop—index <=lo0; 


loop-index++, doubled r 2 * loop—index) ( 
System.out.println("El doble del índice " + loop—index + 


" es + doubled); 


1 
Este es el resultado: 


C:X>Java app 


El doble del índice ES 
1 doble del índice 1 es 2 
1 doble del índice 2 m i 


L doble del índice as l 
doble del índice f ei 
doble del índice 5 =m 1 
L doble del índice E wa 12 
L doble del índice . 14 
L doble del índice ll ès 

L doble del índice E è E 
L doble del índice 1 1 


H 


wH oa a a A e a a d t 
H 


En un bucle for no es obligatorio rellenar todos los elementos; de hecho, 
se pueden utilizar sentencias null. Esto es un ejemplo en el que se suman 
todos los elementos de un array en un bucle for que no tiene código en su 
cuerpo: 


public class app 
{ 


public static void main (String[] args) 


int arrayil = (1. 2, 3, 4, 51, sum = 0; 


for (int loop—index = O, 
loop—index < array.length; 
eum + = array[loop-index++]) 5 


System.out.println("Lasuma = + sum); 


1 
Este es el resultado: 


c:\>java aPP 

La suma = 15 

También se puede convertir un bucle while en un bucle for. A continua- 
ción se ha adaptado el ejemplo del factorial del punto anterior "Bucle while". 


public class app 


public static void main (String[] args) 


{ 


int value = 6, factorial = 1, temp; 
temp = value; //copia temporal. 


for ( ;t- >O Jq 
factorial *= temp-; 
1 


System.out.println(value + "! = "+ factorial); 


Bucles anidados 


"Estoy trabajando con arrays de dos dimensiones", dice el programador 
novato", y me gustaría tener un bucle dentro de otro para poder recorrer las 
dos dimensiones”. "Por supuesto que puede usar unos bucles dentro de otros", 
le contesta. 

Java permite anidar bucles, uno dentro de otro. Esto es un ejemplo en el 
que se ve cómo funciona (en este caso, se haya el valor medio de los elemen- 
tos de un array de dos dimensiones recorriendo todos los elementos con dos 


bucles for): 


public class app 
{ 


public static void main (String[l args) 


( 
double array[1 [1 = ((1, 2, 31, 


13, 2, 1). 
(1, 2, 3)); 
int sum = 0, total = 0; 


for (int outer—index = 0; outer—index ce array.length; 
outer-index++) ( 
for (int inner—index = 0; inner—index < 
array[outer-indexl.length; inner-index++) ( 


sum += array[outer-index] [inner—index]; 
total++; 


System.out.println("Valormedio del array= "+ (sum/ total)); 


} 
Este es el resultado: 


C:\>java app 
Valor medio del array= 2 


Sentencia break 


El programador novato tiene otro problema: "Estoy recorriendo un array 
multidimensional, y algunas veces, al insertarse en cinco bucles anidados, los 
resultados exceden el máximo valor permitido, por lo que quiero terminar 
todos los bucles. ¿Cómo lo hago para que todos ellos terminen de forma 
natural?" "Usando la sentencia break", le responde. 

Algunos lenguajes incluyen la sentencia goto que se puede utilizar para 
saltarse alguna sentencia del código, pero la mayor parte de los lenguajes 
consideran que goto no es estructurada (Java es de ésos y no incluye la 
sentencia goto). Como Java no tiene una sentencia goto, soporta la sentencia 
break con este propósito. 

Se puede usar la sentencia break para terminar un bucle, como en el 
siguiente caso, en el que se termina un bucle si la suma es mayor que 12: 


public class app 
( 


public static void main(String[] args) 


doublearrayl11l = 11, 2, 3, 4, 5, 6, 7, 8, 9, 10); 
int sum = 0: 


for (int loop—index = 0; loop—index e 
array.length; loop-index++) ( 


sum += array[loop—index] ; 

if (sum> 12) break; 

System.out.println("Recorriendo el bucle..."); 
1 


System.out.println("La suma excede el valor máximo."); 


Este es el resultado: 


c:\>java app 

Recorriendo el bucle... 
Recorriendo el bucle... 
“ecorriendael bucle... 
“ecorriendoel bucle... 

La suma excede el valor máximo 


¿Qué ocurre si se quiere salir de varios bucles anidados? En ese caso, se 
pueden etiquetar los bucles e indicar de cuál se quiere salir. Esto es un 
ejemplo en el que se sale de un bucle doblemente anidado: 


public class app 
( 
public static void main (String[l args) 


I 


double array[l[l = (11, 2, 31, 
(35.2 TL, 
(Iy 2, Li 
int sum = 0; 
outer: for(int outer-index = 0; outer-index < array.length; 
outer-index++) ( 
inner: for(int inner-index = 0; inner-index < 


array [outer-index] .length; inner—index++) ( 


sum += array[outer-index] [inner-indexl; 
if (sum > 3) break outer; 


1 


System.out.println("Novoy a imprimir."); 


System.out.println("Elbucle ha terminado."); 


Este es el resultado: 


C:X>Java app 
“1 bucle ha terminado 
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Observe que si no se usa una etiqueta con la sentencia break, sólo se saldrá 
del bucle actual. 


Sentencia continue 


174 


"Me gustan los bucles", dice el programador novato, "sólo hay un proble- 
ma. Algunas veces, cuando estoy recorriendo un bucle, tengo un valor que no 
quiero usar y querría saltármelo y pasar a la siguiente iteración del bucle sin 
ejecutar nada. ¿Puedo hacerlo?" "Sí, por supuesto", le responde. "Puede usar 
la sentencia continue". 

Para pasar a la siguiente iteración de un bucle, se puede usar la sentencia 
continue. Esto es un ejemplo en el que se obtienen los inversos y se intenta 
evitar el inverso de O. Si el índice del bucle actual es Q se pasa a la siguiente 
iteración. Este es el código: 


public class app 
I 
public static void main (String|] args) 
i foridouble loop—index = 5; loop—index > -5; loop-index-) ( 
if (loop—index == 0) continuo; 
System.out.println("El inverso de 


“o = + (1/ loop—index)); 


+ loop—index + 


Este es el resultado del código (observe que esta salida se ha saltado la 
línea en la que el código intenta calcular el inverso de O): 


C:X>java app 


El inverso de 5.0 = 0.2 

El inverso de 4.0 = 0.25 

El inverso de 3.0 = 0.3333333333333333 
El inverso de 2.0 = 0.5 

El inverso de 1.0 = 1.0 

El inverso de -1.0 = -1.0 

El inverso de -2.0 = -0.5 

El inverso de -3.0 = -0.3333333333333333 
El inverso de -4.0 = -0.25 


m Programación 
orientada 
a objetos 


Este capítulo es común a cualquier programa de Java: programación orien- 
tada a objetos (POO). La vimos en el capítulo 1, ya que, sin ella, no se puede 
escribir código en Java. Ahora que ya conocemos la sintaxis básica de Java, 
estamos preparados para trabajar, de manera formal, con la programación 
orientada a objetos. 

La programación orientada a objetos es, realmente, otra técnica para 
implementar el famoso dicho de la programación: "divide y vencerás". La 
idea es encapsular datos y métodos en objetos, de forma que cada objeto sea 
semiautónomo, encerrando métodos y datos privados (es decir, internos) y 
salvándolos del desorden general que les rodea. Así, el objeto puede interactuar 
con el resto del programa por medio de una interfaz bien definida por sus 
métodos públicos (es decir, se les puede invocar desde fuera). 

La programación orientada a objetos fue creada para gestionar programas 
más grandes y descomponerlos en unidades funcionales. Esto nos lleva al 
siguiente paso, que consiste en dividir un programa en subrutinas, ya que los 
objetos pueden contener múltiples subrutinas y datos. El resultado de 
encapsular partes de un programa en un objeto es que es concebido como un 
elemento sencillo y no hay que tratar todo lo que el objeto hace internamente. 

Como ya se vió en el capítulo 1, suponga que su cocina está llena de 
tuberías, bombas, un compresor y todo tipo de interruptores para mantener la 


temperatura ideal de la comida. Cada vez que esta temperatura sea demasiado 
alta, habrá que encender el compresor, abrir las válvulas y empezar a mover 
las bombas manualmente. Ahora bien, toda esa funcionalidad se puede cubrir 
con un objeto, un frigorífico, en el que todas esas operaciones se gestionan 
internamente, realimentándose todas las partes de su interior de forma auto- 
mática. 

Esta es la idea que hay detrás de la encapsulación: parte de un sistema ' 
complejo que necesita mucha atención y lo convierte en un objeto que gestio- 
na todo internamente con su propio trabajo y puede ser fácilmente, concebi- 
do, como un frigorífico. Si el primer principio de la programación orientada a 
objetos es "divide y vencerás", el segundo es "fuera de la vista, fuera de la 
mente". 

En Java, la programación orientada a objetos gira sobre algunos conceptos” 
clave: clases, objetos, miembros de datos, métodos y herencia. De forma 
rápida, estos términos significan: 


e Una clase es una plantilla desde la que se pueden crear objetos. La 
definición de una clase incluye especificaciones formales para la clase y 
cualquier dato y métodos incluidos en ella. 


N 


e Un objeto es una instancia de una clase, al igual que una variable es una 
instancia de un tipo de dato. Se puede pensar en una clase como el tipo 
de un objeto y se puede pensar en el objeto como una instancia de una 
clase. Los objetos encapsulan métodos y variables de instancia. 


e Los miembros de datos son esas variables que forman parte de una clase. 
y en ellas se almacenan los datos que usa el objeto. El objeto soporta 
variables de instancia, cuyos valores son específicos del objeto, y 
variables de clase, cuyos valores son compartidos entre los objetos de 
esa clase. 


e Un método es una función construida en una clase u objeto. Se pueden” 
tener métodos de instancia y métodos de clase. Con objetos, se usan los 
métodos de instancia, pero se puede usar un método de clase haciendo 
referencia, simplemente, a la clase por su nombre, sin requerir ningún 
objeto. 


x x z 7 
e Herencia es el proceso que consiste en derivar una clase, llamada clase 
derivada, de otra, llamada clase base, y se pueden utilizar los métodos 
de la clase base en la clase derivada. 


: vt $ 7 
Todos estos conceptos son importantes para la programación orientada a 
objetos y entraremos en cada uno de ellos con más detalle. 


Clases 


En la programación orientada a objetos, las clases proporcionan una espe- 
cie de plantilla para los objetos. Es decir, si se piensa en una clase como un 
molde de galletas, los objetos que se crean a partir de ella, son las galletas. Se 
puede considerar que una clase es un tipo de objeto; se usa una clase para crear 
un objeto y luego se puede llamar a los métodos del objeto desde este código. 

Para crear un objeto, se invoca al constructor de una clase, que es un 
método que se llama igual que la clase. Este constructor crea un nuevo objeto 
de la clase. En este libro, ya hemos creado clases; cada vez que se crea un 
programa Java, se necesita una clase. Por ejemplo, veamos el código necesa- 
rio para crear una clase llamada app, que se almacena en un fichero llamado 
app.java (esta clase crea una aplicación Java): 


public class app 
{ 


public static void main(String[] args) 
I 
System.out .printlní-Hola desde Java!"); 
1 
1 
Cuando se utiliza el compilador de Java, este fichero, app.java, se con- 
vierte en el fichero de bytecode app.class, que gestiona toda la especificación 
de la clase app. 
Entonces, jcómo se crean objetos desde las clases? Veamos la siguiente 
sección. 


Objetos 


En Java, a un objeto se le llama instancia de una clase. Para crear un 
objeto, se llama al constructor de una clase, que tiene el mismo nombre que 
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ella. He aquí un ejemplo en el que se crea un objeto de la clase String, 
pasando la cadena que se quiere incluir en ese objeto al constructor de la clase 
String: 


String S = new String (" ¡Hola desde Java!"); 
Se verá más sobre la creación de objetos con constructores a lo largo de 
este capítulo. ¿Qué se hace con un objeto cuando se dispone de otro? Se 


puede interactuar con él usando sus miembros de datos y métodos; veamos 
las dos secciones siguientes. 


Miembros de datos 
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Los miembros de datos de un objeto se llaman miembros de datos de 
instancia o variables de instancia. Los elementos de datos compartidos por 
todos los objetos de una clase se llaman miembros de datos de clase o 
variables de clase. En este capítulo, se verá cómo se crean variables de 
instancia y variables de clase. Los miembros de datos pueden hacerse accesi- 
bles desde fuera de un objeto, o se puede hacer que sean internos al objeto 
para usar, de forma privada, los métodos del interior del objeto. 

Esto es un ejemplo en el que se muestra cómo se deberían utilizar los 
miembros de datos de un objeto. Supongamos que se tiene una clase llamada 
Data-class, y se crea un objeto de esta clase llamado datal: 


Data—class datal = new Data-class(" ¡Hola desde Java!"); 


Si Data-class define un miembro de dato que es accesible públicamente 
llamado data, se puede hacer referencia al miembro de dato de datal usando 
el operador punto (.), como sigue: 


datal-data 


Esto significa que se pueden meter los datos en datal, de la siguiente 
forma: 


Data—class datal = new Data-class(" ¡Hola desde Java!"); 
system.out.println (datal.data); 


De esta forma, se puede hacer referencia a los miembros de datos de un 
objeto que lo hace accesible públicamente. 

Por otro lado, recordemos que el poder invocar esos datos ocultos es una 
de las motivaciones de la programación orientada a objetos, y dar acceso a 10s 
datos internos de un objeto desde un código externo al mismo no es buena 


idea. En su lugar, muchas veces se da acceso a los datos de un objeto a un 
código externo sólo a través de los métodos del objeto (lo que significa que se 
puede controlar la interfaz del objeto para el resto del programa, comproban- 
do los valores de los datos antes de que esos valores sean almacenados en los 
miembros de datos del objeto). 


Métodos 


Los métodos son funciones de una clase. Generalmente los métodos se 
dividen en aquellos que se usan internamente en la clase, llamados métodos 
privados (private), los que se usan fuera de la clase, llamados métodos públi- 
cos (public) y los que son usados por la clase y sus derivadas, llamados 
métodos protegidos (protected). 

Los métodos privados son, generalmente, llamados en el interior del obje- 
to por otras partes del mismo. En el ejemplo del frigorífico que propusiimos 
al principio de este capítulo, el termostato puede invocar un método interno 
llamado start-compressor cuando llegue el momento de enfriar. 

Una vez que se tiene un objeto que soporta métodos, se pueden usar los 
métodos de esos objetos. En el ejemplo siguiente, se usa el método calculate 
para trabajar con los dos valores de operandl y operand2 y almacenar el 
resultado del cálculo en result: 


Calculator calcl = new Calculator( ); 


result = calcl.calculate (operandl, operanda); 


Java soporta dos tipos de métodos: métodos de clase y métodos de instan- 
cia. Los métodos de instancia, como en el ejemplo calculate, son invocados 
en objetos (es decir, los objetos son instancias de una clase). Los métodos de 
clase, por otro lado, son invocados en una clase. Por ejemplo, la clase 
java.lang.Math tiene un método de clase llamado sqrt que calcula una raíz 
cuadrada, y se puede usar como sigue (no es necesario un objeto): 


public class app 
I 
public static void main (String[l args) 


( 


double value = 4, sqrt; 


sqrt = iath.sqrt (value); 


+ Value + = 


System.out .println("La raíz cuadrada de 
+ sqrt); 
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Esto es lo que se puede ver cuando se ejecuta el código: 


C:X>java app 
La raíz cuadrada de 4.0 = 2.0 


En este capítulo, aprenderá cómo se crean métodos de clase e instancia. 
Antes de entrar en el código, hay un concepto más dentro de la orientación 
a objetos: la herencia. 


Herencia 


La herencia es uno de los aspectos de la programación orientada a objetos 
que se ha definido formalmente. Utilizando la herencia, se puede derivar una 
nueva clase a partir de una antigua, y la nueva heredará todos los métodos y 
miembros de datos de la antigua. La clase nueva se llama clase derivada y la 
clase original, clase base. La idea es añadir lo que se quiera a la nueva clase 
para darle más funcionalidad que a la clase base. 

Por ejemplo, si se tiene una clase llamada vehículo, se podría derivar una 
nueva clase llamada coche y añadir un nuevo método llamado claxon que 
visualiza "beep" cuando se le llama. De esta forma, se ha creado una nueva 
clase de la clase base y hemos ampliado esa clase con un método adicional. 

La herencia es un tema importante en Java, ya que se puede usar la gran 
librería de clases disponible, derivando de ellas nuestras clases propias. Ve- 
remos cómo utilizar la herencia orientada a objetos en el capítulo siguiente. 

Ahora que ya hemos visto los conceptos de POO, es hora de que vayamos 
a la sección siguiente y revisarlos POO en detalle. Todo este material es 
esencial para la programación de Java, por lo que conviene profundizar en él 
hasta que se domine. 


Declaración y creación de objetos 


El programador novato aparece, preparado para discutir la programación 
orientada a objetos. "Ya sé todo sobre los objetos", dice, "sólo..." "¿Sólo 
qué?" le pregunta. "Sólo que no sé cómo crear un objeto en un programa". 

Antes de utilizar un objeto, es necesario declararlo. Se pueden declarar 
objetos de la misma forma que se declaran variables de tipo de datos senci- 
llos, pero se puede usar la clase como tipo de objeto. Además, se puede usar 
el operador new para crear objetos en Java. Veamos un ejemplo que utiliza la 
clase String. 


Para empezar, declararemos un nuevo objeto, sl, de la clase String: 


public class app 
I 


public static void main (String[] args) 


{ 
String sl; 


Aunque al declarar una variable simple se crea esa variable, la declaración 
de un objeto no la crea. Para crear el objeto se puede usar el operador new con 
el siguiente formato en el que se pasan parámetros al constructor de la 
clase: 


object = new clase ([parámetrol [, parámetro2...111; 


La clase String tiene varios constructores, como vimos en el capítulo 2. Se 
pueden pasar cadenas entre comillas a uno de los constructores de la clase 
String; por lo que se puede crear el nuevo objeto, sl, como sigue: 

public class app 

I 


public static void mainíString[1l args) 


{ 
String SI; 
sl = new String ("iHola desde Java!"); 


Ahora, el nuevo objeto, s1, existe y ya se puede utilizar. Por ejemplo, para 
convertir todos los caracteres de sl a minúscula, se puede usar el método 
toLowerCase de la clase String: 


sl. .EoLowertCase | ) 


Además se pueden combinar la declaración y creación en un solo paso. 
Esto es un ejemplo en el que se declara un nuevo objeto String, s2, creándolo 
con el operador new, todo en una línea: 
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public class app 
i 
public static void main(String[l args) 
I 
String sl; 
sl = new String(";Holadesde Java!"); 


String s2 = new String(";Hoia desde Java!"); 


Las clases, con frecuencia, tienen varios constructores, cada uno de los 
cuales tiene diferentes especificaciones de datos (es decir, diferentes tipos y 
número de parámetros; el compilador sabe qué constructor es el que se quiere 
usar por el tipo y por el número de parámetros). En términos de orientación a 
objetos, estos constructores están sobrecargados (se verá la sobrecarga en 
este capítulo). 

Por ejemplo, el constructor de la clase String está sobrecargado para coger 
arrays de caracteres, asícomo cadenas de texto, por lo que se puede crear un 
objeto nuevo, s3, usando un array de caracteres: 


public class app 
i 
public static void main (String[] args) 


{ 
String sl; 


sl = new String("iHoladesde Java!"); 


String s2 = new String("iHoladesde Java!"); 


Char cl[] {\H', 'on, -11 "a" 1 * "a —h, 31,5 
String s3 = new String(cl); 


Algunas veces las clases tendrán métodos que devuelven objetos, lo que 
quiere decir que usarán internamente el operador new (y nosotros no lo 
tenemos). Esto es un ejemplo en el que se usa el método valueOf de la clase 
String, para convertir un double en un objeto String: 


public class app 
{ 
public static void main(String[] args) 


{ 
String sI} 
sl = new String("iHoladesde Java!"); 


String s2 = new String("¡Hola desde Java!"); 


char cl[] HY- o O A A AS SE ES Cr) 
String s3 = new String (cl); 


double doublel = 1.23456789; 
String s4 = String value0f (doublel): 


Además, se puede asignar un objeto a otro, como se puede ver aquí: 


public class app 
t 


public static void main(String[] args) 


{ 
String SI; 
sl = new String("iHoladesde Java!"); 


String s2 = new String ("iHoladesde Java!"); 


char A CHE totp. Tipo A A AS A e 
String s3 = new Stringícl); 


double doublel = 1.23456789; 
String s4 = String.value0f (doublel); 


String 85; 
s5 = al; 


Internamente, lo que está ocurriendo realmente es que la referencia al 
objeto de sl se copia en s5. En la práctica, esto significa que sl y s5 se 
refieren al mismo objeto. 

Esto es importante saberlo, porque si se cambian los datos de instancia de 
sl, también se están cambiando los de s5 y viceversa. Si dos variables hacen 
referencia al mismo objeto, hay que tener cuidado; muchas referencias a un 
mismo objeto pueden producir errores que son muy difíciles de detectar. Esto 
generalmente ocurre porque se cree que se está tratando con diferentes obje- 
tos. 

Al final del código anterior, se visualizan todas las cadenas creadas. Esto 
es lo que aparece al ejecutar el programa: 


C:i>java app 
¡Hola desde Java! 
¡Hola desde Java! 

Hola ahí 
1.23456789 
;Hola desde Java! 


Así es como se declaran y se crean los objetos, de la misma forma que se 
declaran y crean variables sencillas, con el valor añadido de poder configurar 
objetos pasando datos a un constructor de la clase. Ya es hora de empezar a 
crear nuestras propias clases y empezaremos con este proceso en el siguiente 
punto. 


Declarar y definir clases 


El programador novato (PN) está nervioso y dice, "¡LOhe conseguido! 
i 

¡He creado un objeto, y funciona!" "Bien", le dice, con aprobación, "ahora 

¿cómo se crearía una clase?" "Uh-oh", dice el PN "¿cómo se hace?" 

En Java, la creación de una clase se realiza en dos pasos: la declaración de 
la clase y su definición. Con la declaración se dice a Java lo que necesita 
saber sobre la nueva clase. Esta es la forma general de la declaración de una 
clase: 


[access] class nombre de clase [extends ...] [implernents ...l 
i 
//aquí va la definición de la clase. 
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La implementación de la clase es lo que se llama definición de clase, y se 
hace en el cuerpo de la declaración, como se ve en el ejemplo anterior. Esta es 
la forma general de una definición y declaración de la clase: 


access class nombre de clase [extends ...] [implements...l 


{ 


[accessl [staticl tipo variable-de-instancial; 


[access] [staticl tipo variable-de-instanciaN; 


[accessl1 [staticl tipo métodol (lista-deqarámetros) 
( 


[accessl [staticl tipo métodoN (lista-deparámetros) 


( 


Aquí, la palabra clave static convierte variables en variables de clases o 
métodos en métodos de clase (en contraposición a las variables y métodos de 
instancia), como veremos más tarde. El término access especifica la accesibi- 
lidad de la clase o de un miembro de clase al resto del programa y puede ser 
public, private o protected. Además, hay un acceso por defecto si no se 
especifica ningún tipo; se verá más sobre esto en las páginas siguientes. Se 
usan las palabras clave extends e implements con la herencia, como veremos 
en el siguiente capítulo. 

Con un ejemplo, quedará claro. Para empezar, crearemos una clase muy 
sencilla llamada printer que define un método, print (ya vimos este ejemplo 
en el capítulo 1). Cuando se llama al método print, se visualiza el mensaje 
"¡HOla desde Java!" en la pantalla. Así sería la clase: 


class printer 


( 
public void print0 


C 
System.out.println(-ola desde Java!); 


> 


Ahora se puede usar el método print en otras clases, como en este ejem- 
plo, en el que se está creando un nuevo objeto de la clase printer usando el 
operador new y el método print de ese objeto en una aplicación llamadaapp: 


class printer 
( 
public void printo 


( 


System.out.println("¡Hola desde Java!") ; 
1 


public class app 
( 


public static void main (String[ 1 args) 
c 
printer printerl = new printer ( ); 


printerl.printiip 
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Ahora se pone este código en un fichero, app.java, se compila y se ejecuta 
como sigue: 


C:\>java app 
¡Hola desde Java! 


Tomemos un momento para estudiar este ejemplo; observe que se están 
declarando y definiendo dos clases, printer y app, en el mismo fichero. En 
un fichero sólo una clase puede ser declarada como pública y en este caso, es 
app. Al fichero se le da el nombre después de esa clase, lo que quiere decir 
que el fichero que la contiene debe ser app.java. Sin embargo, se pueden 
tener tantas clases privadas o protegidas como se quiera dentro del fichero (y 
Java creará diferentes ficheros con extensión ”.class "cuando se compile). 

También se puede dividir este ejemplo en dos ficheros, uno para cada 
clase. Este esprinter.java: 


class printer 


( 
public void print0 


I 


System.out.println("iHola desde Java!"); 
1 
1 


Y este es el nuevo app.java (observe que se tiene que importar la clase 
printer para poder utilizarla, para más detalles sobre la importación de clases, 
ver el capítulo 1): 


import printert 


public class app 
( 


public static void main (String[l args) 


( 


printer printerl = new printer0; 


printeri. printij; 


Crear variables de instancia 


"Hmm", dice el programador novato (PN), "quiero crear una clase para 
"tt. 


almacenar datos, y tengo todo menos un pequeño detalle" ' ¿Sí?'le pregunta. 
"¿Cómo almaceno datos en la clase?" pregunta el PN. 
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En la clase, se pueden almacenar datos de dos formas, como variables de 
instancia o como variables de clase. Las variables de instancia son específi- 
cas para los objetos; si se tienen dos objetos (es decir, dos instancias de una 
clase), las variables de instancia de cada objeto son independientes de las 
variables de instancia del otro objeto. Por otro lado, las variables de clase de 
ambos objetos se referirán a los mismo datos y por lo tanto tendrán el mismo 
valor. En primer lugar, echemos un vistazo a las variables de instancia. 

Asíes como se almacenan datos de instancia en una clase: 


access class nombre de clase [extends ...] [implements ...]l 


( 


[access] tipo variable—de—inctancial; 


[access] tipo variable-de-instanciaN; 


) 


Este es un ejemplo en el que se crea una clase llamada Data que gestiona 
una variable de instancia de tipo String llamada data—string, que contiene el 
texto "¡Hola desde Java!" : 


clasci Data 
c 

public String data-etring = wyHola desde Javalm; 
1 


Ahora, se puede crear un objeto, llamado data, de la clase Data en main y 
hacer referencia a la variable de instanciadata-stringcomo data-data- string. 
Así es el código: 


class Data 


( 


public String data—string = "iHola desde Java!"; 


) 


public class app 
( 


public static void main (String[l args) 


{ 


Data data = new Data(); 


String etring data.data-etring; 


Sya Lam ut-printinistringl 


Como se puede observar, se puede acceder a las variables de instancia 
públicas de un objeto con el operador punto. Sin embargo, recuerde que una 
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Acceso 


de las motivaciones de la programación orientada a objetos es mantener la 
privacidad de los datos. Veremos esto con más detalle en la siguiente 
sección. 


a variables 


"Hey", dice el programador novato, "creía que los objetos encapsulaban 
los datos de forma privada, ¿cómo ese jorobado Johnson ha podido acceder a 
los datos de mis objetos?” "Porque utilizó un especificador de acceso erróneo 
para sus datos", le dice. 

Se puede usar un especificador de acceso, llamado access en el siguiente 
código, para fijar la visibilidad de los miembros de datos de una clase a lo 
largo del resto del programa: 


access class nombre de clase [extends ... ] [implements ...!1 
I 


[access] [static] tipo variable—de—instancial; 


[access] [static] tipo variable-de-instanciaN; 


1 


Los valores posibles de access sonpublic, private y protected. Cuando se 
declara un miembro de una clase como public, es accesible desde cualquier 
lugar del programa. Si se declara como private, sólo es accesible desde la 
clase de la que es miembro. Si se declara como protected, está disponible 
para la clase actual, otras clases del mismo paquete (se pueden agrupar 
librerías de clases en paquetes Java; ya se han visto algunos paquetes Java 
comojava.lang, y se verá cómo crear paquetes customizados más tarde en el 
libro), y clases que son derivadas de esa clase. Si no se usa un especificador 
de acceso, el acceso por defecto es que el miembro de la clase es visible a la 
clase de la que es miembro, a las clases derivadas de la misma que están en su 
mismo paquete y a otras clases del mismo paquete. Los detalles se pueden ver 
en la tabla 4.1. 

Por ejemplo, si se quisiera hacer, en el ejemplo de la sección anterior, que 
la variable de instancia data—string fuera privada a la clase Data, se podría 
declarar private como sigue: 

class Data 

I 


private String data—string = -1Hola desde Javalm; 
> 


public class app 


public static void main (Stringll args) 


{ 


Data data = new Data(); 
String string = data.data-string; 


tem. out .printinistrinog 


Ahora, si se intenta acceder a la variable de instancia data-string desde 
otra clase, como se hizo anteriormente en la clase app, el compilador de Java 
devolverá: 


C:\>javac app.java -deprecation 
app.java:l1Z: Variable data—string in class Data not accessible 
from class app. 

String string = data.data-string; 


A 


1 error 


Tabla 4.1. Alcance del especificador de acceso ( x = dentro del alcance). 


Ubicación Private Sin modificador Protected Public 
Misma clase xX xX X X | 
Subclase del mismo X X X 
paquete 

No subclase del mismo x xX xX 

paquete 

Subclase de otro paquete X X 


No subclase de otro x 
paquete 


Crear variables de clase 


"Oye", dice el programador novato, "tengo una nueva clase llamadacounter, 
y necesito llevar un contador total en una variable llamada counter para todos 
los objetos de esa clase. ¿ ¥ahora qué? Estoy hundido". "No se hunda", le 
dice. "Sólo necesita usar una variable de clase". 

El valor de una variable de clase es compartido por todos los objetos de 
esa clase, lo que significa que será el mismo para todos los objetos. Una 
variable se declara como estática con la palabra clave static (que realmente 


especifica la forma en que el valor es almacenado, como dato estático, en 
contraposición a otras variables, que se almacenan de forma dinámica en 
pilas): 


access class nombre de clase [extends ...] [implements...l 
I 


[access] static tipo variable-de—instancial; 


[access] static tipo variable-de—-instanciaN; 
1 


Esto es un ejemplo en el que se crea una clase llamada data con una 
variable de datos de clase llamada intdata: 


class data 


( 
public static int intdata = 0; 


1 


Ahora se pueden crear dos objetos de la clase data: a y b. Cuando se ponga 
la variable intdata para a con el valor 1, la variable intdata para b será 
también puesta a 1, como se puede ver aquí: 


class data 


( 
public static int intdata = 0; 


1 


public class app 
( 
public static void main(String[] args) 
I 
data a, b; 


a = new data01 
b new data0; 


a: intäata = 1f 

System.o-t.println(-Elvalor de b-intdata = Tg b.intdata); 
1 
Este es el resultado del código: 


C:X>Java app 
El valor de b.intdata = 1 


Si se necesita ejecutar algún cálculo para inicializar variables estáticas, se 
puede hacer en un bloque de código estático, que se etiqueta con la palabra 


clave static; este código se ejecuta sólo una vez, cuando la clase se carga por 
primera vez: 


class data 


1 
public static int intdata = 1; 


public static int doubledintdata; 


static 


c 
doubledintdata = 2 i intdata; 


1 


public class app 
{ 


public static void main(String[] args) 


{ 


data a; 


a = new data0 ; 


System.out.println(El valor de a.doubledintdata= " 7 
a.doubledintdata); 


1 
Este es el resultado del código: 


C:X>java app 
El valor de a.doubledintdata= 2 


Crear métodos 


"De acuerdo”, dice el programador novato, "ya tengo variables de instan- 
cia. ¿Hay algo más que aprender sobre clases?" "Bastante", le dice. " Tome 
una silla y hablemos sobre la creación de métodos". 

Llevamos usando métodos desde que visualizamos nuestro primer mensa- 
je con S=stem.out.printin,por lo que ya está familiarizado con el concepto. 
Un método es un bloque de código al que se puede transferir el control y por 
lo tanto, ejecutar ese código. Asíes cómo se crean métodos en una clase: 


access class nombre de clase [extends ...l [implements ...1 


{ 


[access] [static] tipo métodol (lista de parámetros) 


{ 
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[accessl1 [staticl tipo métodoN (lista de parámetros) 
{ 


Para declarar y definir un método, se puede usar un especificador de 
acceso (ver el siguiente punto) y especificar el tipo de retorno del método si 
se quiere que devuelva un valor. Ejemplos de ellos son int,float, tipo object 
o void, si el método no devuelve ningún valor. Se da el nombre del método y 
se sitúa la lista de parámetros que se le quieren pasar después de ese nombre. 
El cuerpo actual del método, el código que se ejecutará cuando se le llame, 
está encerrado en un bloque de código que sigue a la declaración del método. 

Veamos un ejemplo. De hecho, ya ha visto uno antes en este capítulo, la 
claseprinter. En ese ejemplo, se añadió un método público llamadoprint a la 
claseprinter, se creó un objeto de la claseprinter y se llamó al métodoprint, 
como sigue: 


class printer 


I 
public void print() 


System.out.println(Vola desde Java!"); 


public class app 
( 


public static void mainíString[] args) 


{ 


printer printerl = new printer(); 


printerl.print()j5 


En este caso, el método print no tiene parámetros y no devuelve ningún 
valor, pero se siguen poniendo los paréntesis después del nombre del método; 
es obligatorio cuando se está llamando a un método en Java ya que es la 
forma en que el compilador Java sabe que print es un método y no un 
miembro de datos). Esta es la salida del código: 


C:i>java app 

¡Hola desde Java! 

Hay muchas cosas que conocer sobre la creación de métodos en Java, por 
lo tanto, vamos a verlas a lo largo de los siguientes puntos. Uno de los 
aspectos más importantes de los métodos es que se puede hacer que sean 
puramente internos a un objeto, con el concepto de encapsulación de la 
programación orientada a objetos, y por ahíes por donde vamos a empezar. 


Establecer el acceso a los métodos 


"Ese maldito Johnson", dice el programador novato (PN), "ha estado 
utilizando los métodos internos de mis objetos, aunque yo claramente llamé 
al método internal-use-only. ¿No hay nada más riguroso que pueda utilizar 
para aislar a ese jorobado?" "Sí", le dice, "puede usar un especificador de 
acceso más riguroso". "¡Fantástico!" dice PN. 

A los métodos de una clase se les puede añadir un especificador de acceso, 
como sigue (access es el especificador de acceso): 


access class nombre de clase /extends ...] [implements ...l 


{ 


[access] [static]tipo métodol (lista de parámetros) 


I 


[access] [static]tipo métodoN (lista de parámetros) 


Los valores posibles de access son public, private y protected. Cuando se 
declara un miembro de una clase como public, es accesible desde cualquier 
lugar del programa. Si se declara como private, sólo es accesible desde la 
clase de la que es miembro. Si se declara como protected, está disponible 
para la clase actual, otras clases del mismo paquete y clases que son deriva- 
das de esa clase. Si no se usa un especificador de acceso, el acceso por 
defecto es que el miembro de la clase es visible a la clase de la que es 


miembro, a las clases derivadas de la misma que están en su mismo paquete y 
a otras clases del mismo paquete. Los detalles se pueden ver en la tabla 4.1. 

Esto es un ejemplo en el que se ha añadido un método private a la clase 
printer desarrollada en las secciones anteriores. Este método sólo puede ser 
llamado desde otros métodos de la clase printer, como sigue: 


class printer 


{ 
public void print () 


{ 


internal-use-only (); 


) 


private void internal—use—only () 


I 
System. ~ut .println(-;Holadesde Javalm) ; 


1 
1 


public class app 
{ 


public static void main(String[] args) 


{ 


printer printerl = new printero; 


Cuando se llama al método print de la clase printer, se utiliza el método 
internal-use- only, que no está accesible fuera del objeto, para hacer la visua- 
lización. Este es el resultado del código: 


C:\>java app 
¡Hola desde Java! 


Con frecuencia, es una buena idea hacer que los métodos sean privados o 
protegidos, ya que se reduce o se controla la accesibilidad del método al resto 
del código. 


Pasar parámetros a los métodos 


El especialista en soporte a clientes de la empresa le llama y le dice, 
"Tenemos un problema". "¿Cuál es el problema?" le pregunta. "Su clase 
printer visualiza un mensaje, pero los clientes se están quejando porque 
quieren poder fijar el mensaje que se va a visualizar”. "No hay problema", le 
contesta. "Cambiaré el método print para que acepte parámetros". 


Cuando se declara un método, se puede especificar una lista de parámetros 
separados por comas, que se pasa al método poniéndola entre paréntesis 
después del nombre del método: 


[accessl [staticl tipo métodol ([tipo nombre—degarámetrol [, tipo 
nombre-degarámetro2...111 


Los valores que se pasan al método estarán accesibles en el cuerpo del 
mismo, usando los nombres que se les ha dado en la lista de parámetros. 

Esto es un ejemplo en el que al método print se le pasa la cadena a 
visualizar. El método se declara de forma que Java sepa que aceptará un 
parámetro, un objeto String llamado s: 


class printer 


( 
public void print (String s) 


{ 


Ahora, en el cuerpo del método, se puede hacer referencia al objeto String 
que se ha pasado al método print como S: 


class printer 


( 
public void print (String s) 


{ 
System.out.println(s); 


1 


public class app 
I 


public static void main(String[l args) 


{ 


(new printer ()).print ("¡Hola otra vez desde Java!"); 


1 


Este es el resultado del código: 


C:\>java app 
¡Hola otra vez desde Java! 
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Si hay que pasar más de un parámetro, se pueden especificar en la lista, 
separados por comas: 


class calculator 
int addenn(int 091, int 092) 


int result = opl + 0p2; 


1 


Se puede llamar a los métodos con literales, variables, arrays u objetos, 
como sigue: 


calc.addemíl, intl, arrayl, objl) 


Debería observarse que cuando a un método se le pasa una variable senci- 
lla o un literal, el valor de la variable o literal es lo que se le pasa; este 
proceso se llama paso por valor. 

Por otro lado, cuando se le pasa un objeto o array, realmente se está 
pasando una referencia aese objeto oarray (de hecho, cuando se almacena un 
array u objeto en una variable, lo que realmente se está almacenando es una 
referencia a los mismos). Por esa razón, el código del método llamado tiene 
acceso directo al array u objeto original, no a una copia, por lo tanto si ese 
código cambia algún aspecto del array u objeto, como puede ser un elemento 
del array o un miembro de datos del objeto, el array u objeto originales 
cambian. Veremos más sobre esto en este capítulo. 


Argumentos de la línea de comandos pasados 


a rnain 


En las aplicaciones hay un array especial que se pasa como parámetro al 
método main, un array de objetos String que gestiona los argumentos de la 
línea de comandos que el usuario especificó cuando inició Java. Por ejemplo, 
supongamos que se inicia una aplicación de la siguiente forma: 


c:\>java app Ya es la hora 


En este caso, el primer elemento del array que se pasa a main es "Ya", el 
segundo "es", el tercero "la" y el cuarto "hora". 


Esto es un ejemplo en el que se muestra cómo funciona; esta aplicación 
visualizará todos los argumentos pasados desde la línea de comandos utili- 
zando un bucle sobre el array String que se le pasa como parámetro al 
método main: 


public class app 

I 
public static void main (String[] args) 
I 


System.out.println("Argumentos de la línea de comandos... "); 


for(int loop-index = 0; loop-index < args.length; 
loop-index++) { 


System.out.println ("Argumento 


ý 


= + args[loop-indexl ) ; 


+ loop-index t 


1 
Asíes como funcionaría la aplicación: 


C:\>java app Ya es la hora 
Argumentos de la línea de comandos... 


Argumento 0 = Ya 
Argumento 1 = es 
Argumento 2 = la 
Argumento 3 = hora 


Devolver valores desde los métodos 


El programador novato regresa y dice, "bien, Bay otro problema. El gran 
jefe quiere que cree una clase calculadora que realice operaciones matemáti- 
cas. Sé cómo pasar parámetros a los métodos de esa clase, pero...” "¿Sí?"le 
dice. "No sé devolver los resultados obtenidos después de haber hecho la 
operación”. "Ah", le dice, "use la sentencia return”. 

En un método se utiliza la sentencia return para devolver un valor desde 
un método y en la declaración del método se indica el tipo del valor de 


retorno. 
l[access1  [staticl tipo métodol ([tipo nombregarámetrol [, tipo 
nombregarámetro2...11l) 


El tipo del retorno puede ser cualquier tipo de los que Java reconoce, por 
ejemplo, int, float, double, el nombre de una clase que se ha definido, int[] 
para devolver un array de enteros, oJloat[] para devolver un array defloat. 

Esto es un ejemplo en el que la clase calculator tiene un método llamado 


addem que coge dos parámetros enteros, los suma y devuelve el resultado. 
Asíes como se declara addem: 


class calculator 

I 
int addem(int opl, int op2) 
{ 


Así se devuelve la suma de los valores pasados aaddem, usando la senten- 
cla return: 


class calculator 

( 
int addem(int opl, int op2) 
{ 


return opl + op2; 


1 


Así funciona la clase calculator en un programa: 


class calculator 
{ 
int addem(int opl, int op2) 
( 
return opl + op2; 
1 
) 


public class app 


public static void main (String[l args) 
( 
calculator calc = new calculator (); 


System.o~t.println (~addem(2,2) = + calc.addem(2, 2)); 


Este es el resultado de la aplicación: 


C:\>java app 
addem(2, 21 = 4 


Crear métodos de clase 


"Vaya", dice el programador novato, "he creado mi nueva clase calculator 
con un método estupendo llamado addem, pero ¿por qué tengo que meterme 
en líos creando un objeto de esa clase antes de poder usar el método addem? 
¿No se puede llamar al método directamente?" "Se puede", le dice, "si se 
hace que addem sea un método de clase en vez de un método de instancia". 

Para hacer que un método sea un método de clase, se debe utilizar la 
palabra clave static: 


class calculator 
static int addem (int opl, int o0p2) 
{ 
return opl + op2; 
> 
1 


Ahora, se puede llamar al método addem directamente usando el nombre 
de la clase, sin crear un objeto. Esto es un ejemplo: 


public class app 
( 
public static void main(String[l args) 


( 
system.o-t.println (“-addem(2.2)= =" + calculator.addemí2,2)); 
1 


Este es el resultado del código: 


C:\>java app 
addem (2, 2) = 4 


Además se puede usar un método de clase de la forma usual, como un 
método de un objeto: 


class calculator 
( 
static int addem(int opl, int op2) 
( 
return opl + op2; 


3 


public class app 
I 
public static void rnain(String[] args) 


I 


EN 


calculator calc = new calculatorO; 
system.out .println("addem(2, 2) = m + clac.addem(2, 2)); 


Hay que hacer notar que el método main en una aplicación se declara 
estático porque Java debe llamarlo antes de que exista un objeto. 

Si se declara un método estático (incluyendo el método main de cualquier 
aplicación), sólo puede llamar a otros métodos estáticos y acceder a datos 
estáticos. Además, no puede usar las palabras claves this y super, que hacen 
referencia al objeto actual y a su padre, respectivamente, como veremos en 
este y en el siguiente capítulo. En particular, observe que no puede hacer 
referencia a datos de instancia en un método estático. 


Crear métodos de acceso a datos 


"Ese maldito Johnson", dice el programador novato (PN), "está fisgoneando 
otra vez en el código de mis objetos. Pero esta vez, no puedo declarar todo 
como private, porque el resto del código necesita acceder al miembro de 
datos en cuestión. ¿Qué puedo hacer?" "Puede fijar un método de acceso a 
datos", le contesta", y restringir el acceso a sus miembros de datos de una 
forma bien definida". "iSe lo haré a ese Johnson!" dice PN. E 

Se puede restringir el acceso a los datos de sus objetos usando métodos de 
acceso a datos que deben ser invocados para obtener los datos. Esto es un 
ejemplo en el que se tiene un miembro de datos String llamado data-string: 

class data 


I 


private String data—string = "iHola desde Java!"; 


Se puede dar acceso a este miembro de datos privado con dos métodos: 
getData y setData. El métodogetData devuelve el valor de la variable priva- 
da data—string, como sigue: 


class data 
( 


private String data—string = "¡Hola desde Java!"; 
public String getData0 


1 
return data—string; 


4 
1 
Sin embargo, el método setData restringe el acceso a los datos internos; 
en particular, escribiremos este método para que el código desde el que se 
invoca sólo pueda cambiar los datos internos a una nueva cadena si la longi- 


tud de la misma es menor que 100. Así sería: 


class data 


{ 


private String data—string = "¡Hola desde Java!"; 


public String getData0 
t 


return data—string; 


public void setData (String S) 


1 
if (a.length0 * 100) ( 


data—string = S; 


Ahora se puede utilizar el métodogetData para obtener la cadena interna y 
el método setData para ponerle una nueva. Este es un ejemplo en el que se 
muestra cómo se usa getData: 


public class app 
( 


public static void main (String[! args) 


I 
System.out .println((new dataO) .getDataO0); 


Este es el resultado del código: 


C:X>java app 
¡Hola desde Java! 


Es buena idea utilizar los métodos de acceso a datos para garantizar el 
acceso a los datos internos de los objetos. Usando estos métodos, se puede 
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controlar la interfaz con esos datos y por lo tanto bloquear operaciones que se 
consideren ilegales. 


Crear constructores 


"Hmm", dice el programador novato (PN), "sé cómo usar constructores 
para inicializar los datos de un objeto, como los constructores de la clase 
String que utilizo para meter texto en una cadena, pero... '¿Sí?"le pregunta. 
¿Cómo puedo crear constructores para mis propias clases?" dice PN. 

Crear un constructor para una clase es fácil; basta con añadir un método a 
una clase con el mismo nombre que la clase, sin ningún especificador de 
acceso ni tipo de retorno. Vamos a ver un ejemplo en el que se añade un 
constructor que no tiene parámetros a la claseprinter que hemos desarrollado 
en este capítulo. A este constructor se le llama cuando se crea un objeto de la 
claseprinter y, en este caso, inicializa los datos internos data—string a "¡Hola 
desde Java!" (observe que todavía se necesitan los paréntesis después del 


nombre del constructor cuando se declara, aunque no lleve parámetros): 


class data 


{ 


private String data—string; 


data () 
(H 


data—string = "iHola desde Java!"; 


public String getData0 
1 


return data-=string; 
1 
1 


public class app 
( 


public static void main(String[l args) 

! System.out.println((newdata0 ) .getData0); 
1 
Esto es lo que se verá al ejecutar el programa: 


C:X>java app 
¡Hola desde Java! 


Este constructor es especialmente sencillo porque no utiliza ningún 
parámetro. En la siguiente sección se explica el constructor con parámetros. 


pasar parámetros a constructores 


"De acuerdo", dice el programador novato, "Java está gracioso de nuevo. 
He hecho un constructor para mi nueva clase, pero realmente, el objeto no 
está inicializado con los datos que quiero”. "Hmm", le contesta; "¿pasóalgún 
dato al constructor?" "Uh-oh", dice PN. 

Se pueden pasar datos a los constructores, al igual que se hace con otros 
métodos. Este es un ejemplo en el que se usa la clase printer del punto 


anterior, pasando la cadena que se va a visualizar al constructor de la clase 
printer: 


class data 
I 


private String data—string; 


data (String S) 


{ 
data—string = sS; 
1 


public String getData0 
( 


return data—string; 
1 
1 


public class app 
I 
public static void main (Stringil args) 
( 
System.out.println ((newdata ("iHoladesde Java!") ) .getData0); 
1 
1 


Este es el resultado del código: 


C:Xzjava app 
¡Hola desde Java! 


El paso de parámetros a un constructor funciona de la misma forma que el 
paso de parámetros a cualquier método. 


Un ejemplo completo de clase 


En este apartado se presentará un ejemplo utilizando los conceptos que se 
han discutido a lo largo del capítulo. El siguiente ejemplo simula la progra- 
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mación de una pila. Veremos las pilas con más detalle cuando discutamos las 
colecciones de Java, pero la teoría es sencilla; la programación de una pila 
funciona como una pila de platos. Cuando se pone un plato en la parte 
superior de la pila, se está avanzando un elemento en la pila. Cuando se coge 
un plato de la pila, se está quitando un elemento de la pila. Observe que los 
platos van en orden inverso, si se ponen los platos 1, 2 y 3, cuando se quiten 
de la pila, el plato 3 será el que se quite primero, seguido de los platos 2 y 1. 

Para usar la clasestack, se crea un objeto de la clase, pasando un argumen- 
to al constructor que le indica el tamaño de la pila que se quiere (es decir, 
cuántos enteros se quieren almacenar en ella). El constructor ubica la memo- 
ria para la pila en un array llamado stack—data, y establece un puntero a la 
pila, stackgtr, que apunta al artículo que actualmente está en la parte supe- 
rior de la pila (y es realmente el índice que se utilizará con el array stack—data). 

Luego, se puede utilizar el métodopush de la pila para avanzar un elemen- 
to en ésta, que almacena un dato e incrementa el puntero de la pila hasta la 
siguiente posición del array, o se puede usar el método pop para quitar un 
elemento; el métodopop devuelve el artículo retirado y decrementa el punte- 
ro de la pila. 

Esta aplicación se llama stacker.java; el código añade 10 artículos a la pila 
y después los retira: 


class stack ( 
private int stack-datal[]; 
private int stackgtr; // stackqtr = -1 -> la pila est6 
vacía 


stack (int size) 

I 
stack—data = new int[sizel; 
stackqtr = -1; 


public int pop() 
I 
if(stackgtr == -1) // Pila vacía - devuelve error 
return 0; 
else // Si no, devuelve datos 
return stack-datalstackqtr-1; 


public int push (int push-this) 
{ 
if (stackgtr >= 99) // La pila está llena - devuelve error 
return 0; 
else ( // Si no, almacena datos 
stack-data[++stackgtr] = push-this; 
return 1; 


public class stacker { 
public static void main (String args[1) 
( 
int popped—value; 
stack stackl = new stack(100); 


System.out.println("Aliadiendo valores ahora..."); 

for (int loop-index = 0; loop—index m 10; loop-index++)( 
stackl.push (loop-index) ; 
System.out.println("-alorañadido-> 


+ loop-index); 


System.out.println("Quitandovalores ahora..."); 

for (int loop-index = 0; loop—index < 10; loop-index++) I 
popped—value = stackl.popo0; 
System.out.println ("Valor quitado-> 


+ popped-value); 


1 
Así funciona el programa: 


~:\>javatacker 
Añadiendo valores ahora.. 
Valor añadido-> 
Valor añadido-> 
Valor añadido—> 
Valor añadido—> 
Valor añadido-> 
Valor añadido—) 

Valor añadido-> 
Valor añadido-> 
Valor añadido-> 
Valor añadido-> 
Quitando valores ahora... 
Valor quitado-> 
Valor quitado-> 
Valor quitado-> 
Valor quitado-> 
Valor quitado-> 
Valor quitado-> 
Valor quitado-> 
Valor quitado-> 
Valor quitado-> 
Valor quitado-> 
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Comprender el alcance de las variables 


"Hmm", dice el programador novato, "he definido una nueva variable 
llamada the-answer en un método llamado get-the-answer, y estaba tratando 


de usar esa variable en un método llamado get-a-clue, pero Java dice que la 
variable no está definida". Parece que es cuestión del alcance de la variable, 
no se pueden usar variables declaradas en un método, en otro método”, le 
contestamos. "¿Nose puede?", pregunta PN. 

El alcance de una variable consiste en las partes del programa en las que 
esa variable puede utilizarse, y como se puede ver desde el punto de vista del 
programador novato, el alcance es un concepto importante. 

Java define tres alcances principales: alcance a nivel de clase, a nivel de 
método y a nivel de bloque de código. 

Si se define un miembro de dato en una clase, estará disponible en la clase, 
y posiblemente más allá, como se ha visto con los especificadores de acceso 
private, public y protected. 

El alcance de un método se inicia cuando el flujo de la ejecución entra en 
el método y termina cuando dicho flujo lo abandona. Las variables declaradas 
en el método sólo son visibles en el propio método. Los miembros de datos 
de la clase también son visibles en los métodos de la clase, como los parámetros 
pasados a esos métodos. 

También se puede definir un alcance local para las variables utilizadas en" 
bloques de código, ya que se pueden declarar variables en esos bloques. Las 
variables que se declaran en un bloque de código sólo serán visibles en él y en 
los bloques de código que estén contenidos en el primero. 

La forma más fácil de tener esto en mente es saber que las variables no" 
estáticas declaradas en un bloque de código comprendido entre llaves, se 
crean y almacenan en una pila local cuando se entra en el bloque de código y 
se destruyen cuando se abandona dicho bloque (por eso se llaman variables 
dinámicas). Las variables estáticas, por otro lado, se almacenan en la alocación 
de datos propios del programa, no en cualquier pila, y por tanto no están fuera 
del alcance. Están cercanas a las variables globales (es decir, variables para 
todo el programa) que Java permite. 

He aquí un ejemplo en el que se muestran varios niveles de alcance (clase, 
método y bloque de código): 


class Class 


( 


int intl = 1; //visible para todo el código de la clase 


public void methodiint int2) //visible para todo el código de este 
método. 


{ 
int int3 = 3; //visible para todo el código de este método. 


if(intl != int21 { 


int int4 = 4; //visiblesólo en este bloque de código. 


System.out.println("intl = + intl 


+ " int2 = " + int2 
+ " int3 = " + int3 
+ " int4 = " + int4); 


public class app 
{ 


public static void main(String[l args) 


I 


Class c = new Class (); 


Esto es lo que se ve cuando se ejecuta el código: 


C:\>java app 
intl = 1 int2 = 2 int3 = 3 int4 = 4 


Recursividad 


El programador novato entra muriéndose de risa y dice, "nunca pensé que 
el zar de la Programación Exacta me lo dijera: en C++, los métodos se pueden 
llamar a sí mismos". "También en Java", le contesta. "IEh?" dice PN. 

Cada vez que se llama a un método en Java, Java sitúa nuevo espacio en su 
pila interna para todas las variables del método, lo que quiere decir que no 
hay razón para que no se pueda llamar al mismo método otra vez, pues un 
nuevo conjunto de variables será alocado en la pila automáticamente. Lo que 
es más, un método puede llamarse a sí mismo en Java; a esta técnica se la 
llama recursividad. 

El ejemplo clásico de recursividad es calcular un factorial, por lo tanto, lo 
implementaremos aquí. Para calcular el factorial de un entero positivo n, que 
se escribe como "n! ",se calcula lo siguiente: 


Este proceso se presta a la recursividad fácilmente, porque cada estado de 
la recursividad puede calcular una operación en la que multiplica el número 
que se ha pasado por el factorial del número menos 1. Cuando el número 
llega a 1 después de las sucesivas llamadas, el método vuelve, y el control 
regresa a través de las sucesivas etapas, ejecutando una multiplicación en 


cada etapa hasta que todas las llamadas anidadas han vuelto y se obtiene el 
factorial. 
Así es el código: 


class calculator 


( 
public int factorial(int n) 


I 
if (n == 1) { 
return n; 


1 
else { 
return n * factorialín - 1); 


public class app 
& 
public static void rnain(String[] args) 


{ 


calculator calc = new calculator (); 
Systern.out.println("6!= "+ calc.factorial(6)); 


1 


Esto es lo que devolvería el programa: 


En la práctica, probablemente no se quiera usar la recursividad con mucha” 
frecuencia, pero es bueno saber que está disponible. 


Colección garbage y gestión de memoria 


7 
"Bien", dice el programador novato, "contesta, se aloca más memoria con 


el operador new, pero ¿cómo se libera cuando no es necesaria? ¿Hay un 
operador old?" "¡Qué va!", "Java lo hace todo" 

En algunos lenguajes, como C++, se usa el operador new para alocar 7 
memoria y luego se usa el operador delete para liberarla cuando no se la 
necesita más. Sin embargo, Java no tiene un operador delete. Entonces, 
¿cómo se libera la memoria alocada cuando ya no es necesaria? 

En Java, hay que contar con un proceso ya construido llamado colección” 
garbage. Este proceso es automático, aunque no se pueda predecir cuándo va 
a tener lugar. Java dispondrá de la memoria alocada que no tenga más refe- 
rencias. Para que funcione la colección garbage, se puede poner un artículo a 


null (aunque hacer esto tampoco permite predecir cuándo, si llega el caso, la 
colección garbage empezará a funcionar al ejecutar el programa). 

Veamos un ejemplo en el que se está creando un nuevo objeto y luego se 
pone su variable a null. Dado que no hay más referencias a ese objeto, el 
proceso de la colección garbage lo liberará más pronto o más tarde. Este es el 
código: 

class Data 


{ 
public int intdata = 0; 


Data () 


{ 
intdata = 1; 


1 
1 


public class app 
{ 


public static void main (String[] args) 
t 
Data d = new Data(); 


//algo de código... 
d s null; 
//más código... 

1 


Recordemos, por tant, que cuando algún elemento de datos, incluyendo 
objetos y arrays, se ha situado con el operador new, se pueden poner sus 
referencias a null, y si Java necesita más memoria, comenzará el proceso de 
la colección garbage. Sin embargo, se tiene que tener cuidado y evitar las 
referencias circulares. 


$o dónde estgn los punteros en Java, y la respuesta es que no tiene. Los 
diseñadores de Java omitieron tos punteros por razones de seguridad, 
para asegurarse que los programadores no podían acceder a la memoria 
mas allá de los limites legales. En lugar de punteros, Java usa referen- 


Pa 


Evitar las referencias circulares 


La colección garbage, liberación de memoria de aquello que no tiene más 
referencias en el programa, arranca automáticamente. Sin embargo, se debe- 
rían evitar las referencias circulares en las que un objeto hace referencia a 
otro y el segundo al primero. 

Cuando se liberan todas las referencias a estos objetos en un programa, 
cada uno todavía tiene una referencia interna al otro, lo que significa que la 
colección garbage no puede actuar en el otro objeto. Peor todavía es que, 
como no hay referencias externas al objeto, no se puede llegar a ese objeto 
para cambiar la situación. Ambos objetos estarán en memoria, consumiendo 
recursos, hasta que el programa finalice. 

Este es un ejemplo en el que se muestra lo que hemos querido decir: en él, 
la clase a tiene una referencia interna a un objeto de la clase b, y la clase b, 
una referencia interna a un objeto de la clase a. Cuando el código de main 
pone la referencia, tiene uno de estos objetos anull, y estos objetos continua- 
rán ocupando memoria hasta que el programa finalice. Este es el código: 


class a 


b bl; 


public class app 
I 


public static void main (String[] args) 


( 


a obj = new a(); 
-7 
obj = null; //¡existen referencias circulares inaccesibles! 


> 
Sólo hay una forma de evitar esto, y es liberar las referencias circulares 
antes de ir a la aventura. En la práctica, esto generalmente quiere decir que se 


1 


ponen las referencias de un objeto a otros objetos a null antes de poner la 
referencia del objeto, en sí mismo, a null. Algunas veces, es posible hacer 
esto en el métodofinalize (para más detalles, ver el siguiente apartado). 

Mientras estamos viendo la gestión de memoria, hay que notar que se 
tiene algún control sobre la alocación de memoria como un todo (ver la 
opción de la línea de comando -J en el capítulol, que permite fijar la cantidad 
de memoria total alocada cuando el programa se ejecuta). En general, Java 
gestiona la memoria en los programas. 


Colección garbage y el método fínalize 


"Hmm", dice el programador novato, "entonces Java tiene un recolector 
de basura que retira de la memoria los artículos que no están referenciados 
ya. ¿Hay algo más que yo debería saber sobre este proceso?" "Una cosa", le 
responde. "Garbage llama a un método especial, finalize, si existe, y se 
puede usar este método para limpieza de última hora”. 

Cuando un objeto está dentro del proceso de garbage (ver el punto ante- 
rior), este recolector llama a un método del objeto llamadofinalize, si existe. 
En este método se puede ejecutar el código de limpieza y, con frecuencia, es 
buena idea liberar cualquier referencia a otros objetos que tenga el objeto 
actual para eliminar la posibilidad de referencias circulares (también visto en 
este capítulo). 

Esto es un ejemplo: 


class Data 

( 
public int intdata = 0; 
super-iantSizeCiasssgsc; 


Data() 
( 

intdata = 1; 

sgsc = new SuperGiantSizeClass (100000000); 
1 


protected void finalizeo 


{ 
sgsc = null; 


1 
1 


public class app 


( 
public static void main(String[] args) 
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Data d = new Data()5 


d = null; 


Sobrecarga de métodos 


21d 


"Todavía estoy trabajando con mi nuevo programa, SuperDuperMathPro", 
dice el programador novato, "y tengo una gran clase llamada calculator con 
un método llamado addem que suma dos números. Además, me gustaría 
sumar tres números juntos, por lo que creo que tendré que escribir un nuevo 
método". "En absoluto", le dice. "Puede sobrecargar el método addem para 
que maneje dos o tres operandos". "¿Cómo se hace eso?" pregunta PN. 

La sobrecarga de métodos es una técnica de la orientación a objetos que 
permite definir diferentes versiones de un método, todos con el mismo nom- 
bre pero con diferentes listas de parámetros. Cuando se usa un método sobre- 
cargado, el compilador de Java sabrá cuál es el que se quiere utilizar por el 
número yl0 tipo de parámetros que se le pasen, y buscará la versión del 
método con la lista de parámetros correcta. 

Veamos un ejemplo. Para sobrecargar un método, sólo hay que definirlo” 
más de una vez, especificando una nueva lista de parámetros en cada una de 
ellas. Cada lista de parámetros debe ser diferente de cualquier otra de alguna 
forma, el número de parámetros o el tipo de uno o más de ellos, por ejemplo. 
Crearemos el ejemplo sobre el que el programador novato estaba preocupado. 
Primero, se añade una versión del método addem a la clase calculator que 
manejará dos operandos: 


class calculator 
I 
int atitieem(int opl, int 092) 
I 
return opl + 092; 


Luego se añade otra versión del mismo método que acepte tres operandos: 


class calculator 


( 
int addem (int opl, int op2) 


return opl + op2; 
1 


int addem(int opl, int 092, int 093) 
E 
return opl + 092 + 093; 


1 


Ahora se pueden usar ambos métodos en el código, como sigue: 


public class app 
1 
public static void main(String[] args) 
I 
calculator calc = new calculator (); 


Sfitea.cut.printla("addea(2, 2 = =" + 24ale.adden(2, 21); 
Syotsm.cout  princin¡"adden(2, 3, 1) = * + calc added, 1, Itii 


Este es el resultado del programa: 


C:\>java app 
addem(2, 2) = 4 
addem(2, 2, 2) = 6 


Como se puede ver, la sobrecarga proporciona una técnica potente, espe- 
cialmente en el código que se entrega a otros desarrolladores, porque permite 
pasar diferentes listas de parámetros a un método, haciéndolo más fácil de 
usar de diferentes formas en el código. 

Además se pueden sobrecargar los constructores; (ver el siguiente punto 
para más detalles). 


Sobrecarga de constructores 


Dice el programador novato: "Entonces, ¡se pueden sobrecargar métodos 
en Java para que manejen diferentes listas de parámetros! ¿También se pue- 
den sobrecargar constructores?" "Por supuesto”, le dice. "Considere la clase 
String de Java, que tiene un constructor al que se le pueden pasar cadenas, 
arrays de caracteres y otro tipo de datos”. " Es cierto", dice PN. 

La sobrecarga de constructores funciona como la sobrecarga de otros 
métodos (ver el punto anterior para más detalles): sólo hay que definir el 


constructor un número de veces, cada una con una lista de parámetros dife- 
rentes. 

Veamos un ejemplo que imita los constructores de la clase String de Java 
en el que esta nueva clase, la clase data, tendrá un constructor al que se le 
puede pasar un array de caracteres o una cadena. Esta clase simplemente 
almacenará los datos que se le pasen y hará que los datos estén disponibles 
con un método getData. 

Así es cómo se declara y define el constructor que toma un array de 
caracteres: 


class data 
t 
private String data—string; 


ciata(charl 1 c) 


1 
data—string = new String(c); 


1 
Asíes como se declara el constructor que acepta una cadena de texto: 


class data 
1 


private String data—string; 
dapa ornar | 


data—string = new String(c); 


ciata (String S) 


ll 
data—string = S; 


1 
Lo único que queda es añadir el método getData: 


class data 
I 


private String data—string; 


dataíchar[l c) 
t 
data—string = new String (c); 


1 


data (String S) 


{ 
data—string = S; 


public String getData0 
c 


return data—string; 
1 
1 


Ahora se pueden usar ambos constructores en el código, crear objetos y 
visualizar el texto almacenado, como sigue: 


public class app 


public static void main(String[] args) 


{ 
char chaáararrtay it = ('H', 'o', '1', 'a'); 
System.out.grintln( (new data (chararray) ) .getData ()); 


«“ystem.out .grintln ( (new data ('iHola desde Java!")).get-ata(); 
1 
Este es el resultado del código: 


C:X>java app 
Hola 
¡Hola desde Java! 


Pasar objetos a métodos 


El programador novato aparece y dice, "Otra vez Java está en plan gracio- 
so. Pasé un objeto a un método porque quería hacer una prueba de destruc- 
ción en ese método, pero al devolver el control, el objeto original estaba 
destruido. ¿Qué ha ocurrido?” "Java pasa objetos por referencia, " le contesta. 
"Eso es lo que ha ocurrido”. 

Cuando se pasa un elemento de un tipo de dato sencillo a un método, Java 
pasa una copia de los datos, que se llama paso por valor. Dado que el método 
sólo obtiene una copia del elemento de los datos, el código del método no 
puede afectar al elemento del dato original. 

Este es un ejemplo en el que se pasa un objeto de la clase printer para 
visualizar los datos del objeto: 

class Data 

' public String data—string; 


~ata (Stringata) 
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data-=string = data; 


class printer 


( 
public void print (Data d) 


f 
“ystem.out.println(d.data-string); 


public class app 
( 


public static void main (String[l args) 

I 
Data data = new Data ("1Hola desde Javal"); 
printer p = new printero; 


pP-printidatal 


Este es el resultado del código: 


C:\>java app 

iHola desde Java! 

Como se mencionó anteriormente, dado que los objetos se pasan par 
referencia, el objeto pasado cambia el objeto original. Aquí tenemos un 
ejemplo en el que se pasa el objeto de la clase Data a un método llamado 
rewrite que cambia la variable de instanciadata—string del objeto; esta varia- 
ble empieza con la cadena "¡HOla desde Java!", pero el método rewrite es 
capaz de cambiar la cadena a "¡Hola a Java!" en este código: 


class Data 
public String data—string; 


Data (String S) 
( 


data—=string = new String(s); 
1 


class Class 


I 
public void rewrite (Data d) 


{ 
d.data-string = "iHola a Javal"); 


1 


public class app 


public static void main (String[l args) 

I 
Data d = new Data (niRola desde Java!"); 
Class c = new Class O ; 


oc .reerite(di; 


Este es el resultado del código: 


C:X>java app 
¡Holaa Java! 


Pasar arrays a métodos 


"Entonces, en Java, las variables simples se pasan por valor y los objetos 
por referencia; ahora ya está todo encaminado", dice el programador novato. 
"Todavía no", contestamos. "Hay un tipo más de elemento que se pasa por 
referencia, los arrays". 

Se puede pasar un array a un método tan fácil como se pasa una variable 
simple, pero hay que tener en cuenta que los arrays se pasan por referencia, 
no por valor, lo que significa que si se cambia un array pasado a un método, 
el array original también se ve afectado. 

Veamos un ejemplo. En este caso, se pasará un array a un método llamado 
doubler que duplica cada elemento del array. Dado que los arrays se pasan 
por referencia, los datos del array original también serán duplicados. Este 
sería el código (observe que se visualiza un array antes y después de llamar al 
método doubler): 


class Calculate 
{ 
public void doubler (int a[ 1) 
I 
for (int loop-index = 0; loop—index < a—length; 
loop_iodax:<=*| [ 
a [loop—indexl *=2; 


public class app 
{ 


public static void main(String[] args) 


int array [l = (1, 2, 3, 4, 5); 
Calculate c = new Calculate (); 


Systern.out.println("Antes de llamar a doubler... "1; 
for (int loop—index = 0; loop—index < array.length; 
loop-index++) ( 


System.out.println("array[" + loop—index + 'l = + 


o :doublar[arrāy} 7 

System.out.printlní"Después de llamar a doubler...'); 

for (int loop-index = 0; loop-index e array.length; 
loop-index++) I 


Systern.out.println("array[" + loop-index + "1 = " + 
array[loop-index]) 5 


1 
Este es el resultado del código: 


C:\>java app 

Antes de llamar a doubler... 
arrayL01 = 
arrayrl] = 
array[2] = 
arrayr31l = 
array[4] = 
Después de 
array[O] = 
array [1] = 
arrayL21 = 
arrayL31 = 
array 141 = 


l 
me 


lamar a doubler. 


OOA AN PORA UN 


o 


Usar la palabra clave this 


Los objetos de Java incluyen un miembro de datos llamado this, que” 
realmente es una referencia al objeto actual. La palabra clave this es útil si se 
necesita hacer referencia al objeto actual; por ejemplo, cuando se quiere pisar 
el objeto actual a un método. 

En el siguiente caso, la clase Data tiene un método, printData, que imprl- 
me los datos del objeto actual pasando el objeto al método print de otro 


objeto. La palabra clave this se usa para hacer referencia al objeto actual. Así 
sería el código: 


class Data 
I 


private String data—string; 


Data (String sí 
I 
data—=string = S; 


1 


public String getData0 
1 
return data-string; 


1 


public void printData0 

t 
printer p = new printero; 
p.print (this); 


class printer 


( 
void print (Data d) 


System.out .println (d.getData ()); 


public class app 
I 
public static void mainíString[1 args) 


( 
(new Data ("iHoladesde Java!")).printData(); 


1 


Observe que cuando se llama a p.print, se pasa una referencia al objeto 
actual a p.print, de forma que el código de p.print da acceso al método 
getData del objeto actual, que devuelve los datos internos que se van a 
visualizar. Este es el resultado del programa: 


C:X>Java app 
¡Hola desde Java! 


Devolver objetos desde métodos 


Se pueden devolver objetos desde métodos, igual que ocurre con otros 
tipos de datos. Sin embargo, surge una pregunta: cuando el método que 


devolvió el objeto se queda fuera del alcance, ¿el objeto que él devolvió 
también se queda fuera del alcance? y 

La respuesta es no. Cuando se crea un nuevo objeto usando el operador 
new, ese objeto no es destruido cuando el método que lo creó queda fuera del 
alcance, y el objeto, por sí mismo, no está a disposición del recolector de 
basura hasta que no haya más referencias a él. 

En el ejemplo siguiente, la clase llamada ObjectFactory tiene un método 
llamado getNewObject que devuelve un objeto de la clase CreatedClass: 


class ObjectFactory 


I 
public CreatedClass getNewO0bjectO0 


I 


return new CreatedClassO0; 
1 
1 


class CreatedClass 


I 
public String tag = "Esta es la etiqueta de datos."; 


1 
public class app 


public static void main(String[] args) 


I 
ObjectFactory o = new ObjectFactoryo; 


CreatedClass c = o.getNewO0bjectO0; 


1 


Cuando se llama al método get£NewObject, éste devuelve un nuevo objeto 
de la clase CreatedClass y puede visualizar los datos de ese objeto. Esto es lo 
que muestra el programa al ejecutarlo: 


C:i>java app 
Esta es la etiqueta de datos 


Devolver arrays desde métodos 


Se pueden devolver arrays desde métodos igual que se pueden ES 
objetos y tipos de datos sencillos. Veamos un ejemplo en el que se crea una 
clase llamada ArrayFActory con un método llamado getNewArray. Cuando 
se llama a getNewArray, éste devolverá un array de enteros. Observe que el 
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tipo de retorno que se especifica en la declaración degetNewArray es int[], lo 
que indica que es un array de enteros. Este es el código: 


class ArrayFactory 


( 
public int11 getNewArray () 


( 
int array[l = 11, 2, 3, 4, 5); 


return array; 


1 


Así funcionaría la clase ArrayFactory, creando un nuevo array y 
visualizándolo: 
public class app 


{ 


public static void main(String[] args) 
{ 
ArrayFactory af = new ArrayFactory(); 


int array[l = af.getNewArray () ; 


for (int loop—index = 0; loop-index < array.length; 
loop-index++) { 


System.out.println("array[" + loop-index + "1 = + 
array [loop-index]) ; 


1 
Este es el resultado del código: 


C:\>java app 


array[O0] = 1 
array[11 = 2 
array[2] = 3 
array[31 = 4 
array [4] = 5 
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m Herencia, 
clases internas 
e interfaces 


Este capítulo trata la herencia, tema muy importante en la programación 
con lenguaje Java. Usando la herencia se puede derivar una clase, llamada 
clase derivada o subclase, de otra, llamada clase base o superclase. Se trata 
de añadir lo que se quiera a la nueva clase para darle mayor funcionalidad que 
a la clase original. 

El capítulo anterior empezó con la discusión sobre la programación orien- 
tada a objetos y, como se mencionó allí, si se tiene una clase llamada, 
supongamos, "vehículo", que contiene la funcionalidad básica de algunos 
elementos de transporte, se puede usar esa clase como base de todas aquellas 
que se deriven de la misma, como "coche" y "camión". La clase "coche" 
puede, por ejemplo, tener un miembro de datos llamado "ruedas", inicializado 
a 4, pero el mismo miembro de datos en la clase "camión" debería estar 
inicializado a 18. Además se puede usar la misma clase "vehículo" como la 
clase base para otras, como puede ser la clase "helicóptero". Todas las subclases 
tendrán acceso a los miembros no privados de la superclase y podrán añadir 
los suyos propios. De hecho, pueden sobrescribir los miembros no privados 
de la superclase, sustituyéndolos con su propio código. Por ejemplo, la clase 
"vehículo" podría tener un método llamado go que visualice "Conducir...", y 
la clase helicóptero puede sobrescribir ese método, redefiniéndolo y 
visualizando "Volar...". 


Entonces, por medio de la herencia, puede basar sus clases en otras clases, 
reutilizando y añadiendo código. Se puede usar o redefinir los miembros de 
la superclase como guste, personalizado esa clase para su propio uso. De 
hecho, se pueden crear clases que deban ser tratadas como superclases. Estas 
clases se llaman abstractas. En un objeto, no se puede instanciar directamen- 
te una clase abstracta; en su lugar se debe derivar una nueva clase de la 
primera, sobrescribiendo los miembros que son específicamente declarados 
como abstractos. Las clases abstractas se utilizan para forzar a los 
desarrolladores a customizar algunos o todos los miembros de una clase; por 
ejemplo, se puede tener un método abstracto llamado printError, porque se 
quiere que los desarrolladores suministren su propio código para este méto- 
do, de forma que sea apropiado para las subclases que ellos crean. 

Esta es una visión rápida de lo que hace la herencia. La siguiente pregunta 
es, ¿por qué es tan importante en Java? 


¿Por qué la herencia? 


hi 
hd 


m 


Java es verdaderamente un lenguaje orientado a objetos, y está muy rela? 
cionado con la herencia. Los desarrolladores de Sun Microsystems han crea- 
do enormes paquetes, librerías de clases, llenos de clases que se pueden usar 
como superclases. Esto es importante si, por ejemplo, se quiere crear una 
applet en Java, porque en ese caso, se puede derivar la applet de la clase 
Applet del paquetejava.applet. Aquí está laapplet que se vio en el capítulo 1, 
que crea una superclase basada en la clase Applet usando la palabra clave 
extends (en el siguiente capítulo se verá más sobre applets): 


import Java.applet.Applet; 
import java.awt.*; 


public clase applet extends Applet 
( 
public void paint (Graphics g) 


t 
g.drawString ("iHoladesde Java!", 60, 100); 


1 
1 


Este es otro ejemplo que se vio en el capítulo 1; en este caso, se crea una 
aplicación ventana basándose en la clase de Javajava.awt. Frame: 


import java.awt.*; 
import java.awt.event.*; 


class AppPramo extends Fr- 


public void paint (Graphics g) 
I 
g.drawString(";Holadesde Java!", 60, 100); 


1 
1 


public class app 
( 


public static void main(String [] args) 


( 
AppFrame f = new AppFrame() ; 


f.addWindowListener (new WindowAdapterO { public void 
windowClosing (WindowEvent e) (System.exit (O);}i); 


Como se puede ver, cuando se manejan elementos visuales en los progra- 
mas, hay que tener mucho contacto con los paquetes de Java. Los botones, 
por ejemplo, tienen sus propias clases y para personalizados, se derivan sus 
clases. De hecho, si se quiere gestionar las acciones del ratón o los clics en 
los botones, se tiene que usar la herencia, y esta vez, no se usan las superclases, 
sino las interfaces. 


¿Por qué las interfaces? 


Supongamos que se quiere crear una applet que gestione los clics que se 
hacen en un botón. 

Para crear una applet estándar, se puede derivar una clase de la clase 

java.applet.Applet y para gestionar los clics que se hacen en un botón, se usa 
otra clase, ActionListener. Por lo tanto, la applet se tendrá que basar en 
ambas clases Applet y ActionListener. 

Basar una subclase en dos o más superclases se llama herencia múltiple, y 
Java no soporta la herencia múltiple (aunque sí lo hacen lenguajes como 
C++). En la práctica, esto quiere decir que sólo se puede usar la palabra clave 
extends con una clase. Para resolver este problema, Java implementa las 
clases como ActionListener como interfaces. 

En el siguiente caso, eso significa que la applet se puede extender de la 
clase Applet y usar la palabra clave implements para añadir la gestión del clic 
en los botones. Así quedaría la applet: 


import java.applet.Applet; 
import java.awt.*; 


import jJava.awt.event.*; 
public class clicker extends Applet implements ActionListener ( 


TextField textl; 
Button buttonl; 


public void init () ( 
textl = new TextField(20); 
add (text1) ; 
buttonl = new Button ("iHacer clic aquí!"); 
add (buttonl) ; 
buttonl.addActionListener (this); 


public void actiopnerformed(ActionEvent event) ( 
String msg = new String ("Bienvenido a Java"); 
if(event .getSource () == buttonl) ( 
textl.SetText (msg); 
1 


Se puede implementar tantas interfaces como se quiera; por ejemplo, aquí 
hay parte de un programa que implementa tres listeners para permitir que el 
programa gestione los clics en los botones y las acciones del ratón: 


import java.awt.Graphics; 
import java.awt.*; 

import jJava.awt.event.*; 
import Java.lang.Math; 
import Java.applet.Applet; 


public class dauber extends Applet implements ActionListener, 
MouseListener, MouseMotionListener ( 


Más adelante, se verá cómo se crean las interfaces. Sin embargo, veremos- 
una introducción a las mismas en este capítulo para que podamos utilizarlas 
después. 

Todavía queda un punto por cubrir en este capítulo: las clases internas. 


¿Por qué las clases internas? 


. T 
Java permite crear clases dentro de clases, y la clase encerrada se llama 
clase interna. Empezaremos a trabajar con ellas en este capítulo. Quizás no 


vea mucha necesidad de definir clases dentro de clases en este momento, pero 
lo verá más claro cuando se empiecen a gestionar los eventos de la interfaz de 
usuario, como, por ejemplo, cuando el usuario cierra una ventana. 

Los eventos se gestionan con las interfaces, y cuando se implementa una 
interfaz, también se debe proporcionar la implementación de varios métodos 
abstractos en el interior de la misma. Para que este proceso sea más fácil, 
Java proporciona las clases adaptador, que ya tienen implementaciones va- 
cías de los métodos requeridos. Para gestionar un evento de interfaz de 
usuario de cualquier tipo, es común tener una subclase de las clases adaptador 
como clase interna, sobrescribiendo los métodos que se quiera de una forma 
muy compacta. Este es un ejemplo en el que el código finaliza una aplicación 
cuando el usuario cierra la ventana de la misma: 


public class app 
{ 


public static void main(String [] args) 
I 
AppFrame f = new AppFrameO0; 


f.addWindovlistener (neor windowAdapter0 {public void 
windoffClosing (WindarrEvent e) <System.exit (O);>>); 


Seguiremos este código con detalle cuando trabajemos con eventos, y más 
tarde, introduciremos clases internas para que este código tenga mucho más 
sentido. 

Ahora que ya conocemos los conceptos relacionados con la herencia, las 
interfaces y las clases internas, es hora de empezar con la siguiente sección. 


Crear una subclase 


"De acuerdo", dice el programador novato, "quiero aprender todo lo que 
hay sobre la herencia. ¿Puede explicármelo en dos palabras o menos?" Mien- 
tras cuenta con los dedos, le dice, "No hay forma". 

Veamos un ejemplo en el que se muestra cómo se crea una subclase 
usando le herencia. Suponga que tiene una clase llamada "vehículo" que tiene 
un método start, que se puede utilizar para arrancar el vehículo y que visualiza 
"Arrancar...”: 


class vehiculo 

I 
public void start () 
I 


Systern.o-t.println(--rancar..."); 
? 


Hay otro tipo de vehículos, por lo tanto si se quiere especializar la clase 
"vehículo" en una clase "coche", se puede usar la herencia con la palabra 
clave extends. Así se declara "coche" como una subclase de "vehículo": 


class coche extends vehiculo 


{ 


La sintaxis indica que "coche" es derivada de la clase "vehículo", lo que 
significa que en este caso, "coche" heredará el método start de "vehículo". 
Además se pueden añadir los miembros de datos y métodos propios en las 
subclases. Este es un ejemplo en el que se añade un método llamado drive a la 
clase "coche": 


class coche extends vehiculo 


I 
public void drive0 


{ 
syat~.~ut .printiln (~Conducir..."); 


1 


Ahora se puede acceder a ambos métodos start y drive en los objetos de la 
clase "coche", como se ve en el ejemplo: 


public class app 
( 


public static void main (String[] args) 
I 


System.out.println("Crear un coche..."); 
Coche c = new coche (); 


c.starto; 
c.drive0; 


) 
Esta es la salida del código anterior: 


C:X>Java app 
Crear un coche... 


Arrancar... 
Conducir... 


Este es un ejemplo básico de subclase. Hay mucho más en todo este 
proceso. Por ejemplo, ¿qué pasa si se define un método en una subclase con 
el mismo nombre que un método de la superclase? ¿Cómo se pasan los datos 
al constructor de una superclase? Todo esto lo veremos en el siguiente capítu- 
lo. 


Especificadoresde acceso y herencia 


"Otra vez, Java está gracioso", dice el programador novato. "En una 
subclase, quiero usar algunos métodos de la superclase, pero Java dice que no 
existen" "¿Cuál es el especificador de acceso para los métodos?" le pregunta. 
"Privado", dice PN. "Ese es el problema". 

Los especificadores de acceso se usan con clases, miembros de datos y 
métodos para especificar la visibilidad de esos elementos en el resto del 
programa. Esta es la forma general de declarar y definir las clases, que 
muestra cómo se usan los especificadores de acceso: 


access class nombre de clase [extends ...] [implements...] 


( 
[access] [staticl tipo variable—de—instancial; 


[access] [staticl tipo variable-de-instanciaN; 


[access] [staticl tipo métodol (lista de parámetros) 


[access] [staticl tipo métodoN (lista de parámetros) 


{ 


Los valores posibles deaccess son public, private y protected. Cuando se 
declara un miembro de una clase como public, es accesible desde cualquier 
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lugar del programa. Si se declara como private, sólo es accesible desde la 
clase de la que es miembro. Si se declara como protected, está disponible 
para la clase actual, otras clases del mismo paquete, y clases que son deriva- 
das de esa clase. Si no se usa un especificador de acceso, el acceso por 
defecto es que el miembro de la clase es visible a la clase de la que es 
miembro, a las clases derivadas de la misma que están en su mismo 
paquete y a otras clases del mismo paquete. Se pueden ver los detalles en la 
tabla 5.1. 


Por ejemplo, echemos un vistazo al código del programador novato, en el 


que el método srarr se declara como private pero además se accede a él en 
main: 


class vehiculo 
{ 
private void start0 
I " 
System.out.println("Arrancar... ); 
1 
1 


class coche extends vehiculo 
{ 
public void drive () 
I r 
System.out.println("Conducir... ); 
1 
1 


public class app 
I 
public static void main(String[l args) 
I 
System.out.println("Crear un coche..."); 
coche c = new coche (); 
c.starto; 
c.drive():; 


Tabla 5.1. Alcance para el especificador de acceso (x =en el alcance). 


Ubicación Private Sin modificador Protected Public 


Misma clase X xX X X 
Subclase en el mismo Xx x i 
paquete 

No subclase en el mismo x x X 


paquete 


Ubicación Private Sin modificador Protected Public 


Subclase en otro paque- 
te 


No subclase en otro pa- x 
auete 


Dado que la declaración de un método, usando private, restringe ese 
miembro a su clase, Java dice que no puede encontrar el método start cuando 
se usa en main: 


~:\>c:\jdk1.2.2\bin\javacapp. java -deprecation 
app.java:47: No method matching start () found in class coche 
c.start ():; 


A 


1 error 


Por otro lado, la declaración de un miembro como protected restringe su 
alcance al código del mismo paquete y de la subclase de la clase en la que está 
declarado. Sin embargo, el siguiente código funciona: 


class vehiculo 
( 
protected void starto0 
I 
System.out.println("Arrancar...'1; 
1 
1 


class coche extends vehiculo 
{ 
public void drive () 
( " 
System.out.println ("Conducir ... 1; 


1 


public class app 
( 
public static void main(String[l args) 
( 
System.out.println("Crear un coche..."); 
coche c = new coche(); 
oc-skartila 


Esta es la salida de la aplicación: 


C:X>Java app 
Crear un coche... 


pdi 
Qili 
Lo 


Arrancar... 
Conducir... 


Llamar a los constructores de la superclase 


"De acuerdo", dice el programador novato, "tengo un problema. Sé que 
puedo crear una subclase a partir de una superclase, pero ¿qué pasa si la 
superclase tiene un constructor?" "Hay que pensar un poco". "Hmm", dice el 
PN, pensativo. 

Supongamos que tiene una clase llamada a que tiene un constructor sin 
parámetros: 


class a 


{ 
a() 
I 


Systern.out.println("En el constructor de a..."); 
1 
1 


Luego se deriva una subclase b de a: 


class b extends a 


( 
1 


Ahora, cuando se crea un objeto de la clase b, se llama automáticamente al 
constructor de la clase a: 


public class app 
{ 


public static void main(String[l args) 


( 
b obj = new b0; 


1 
> 
Este es el resultado del código precedente: 


C:\>java app 
En el constructor de a... 


Ahora, supongamos que se añade un constructor sin parámetros a la clase 


System.out.println("En el constructor de a..."); 


1 


class b extends a 


system.out.println("En el constructor de b-"); 


public class app 
{ 


public static void mainíStringll args) 


I 
b obj = newboO0; 


1 


En este caso, cuando se crea un objeto de la clase b, se llama a los 
constructores de a y b: 
C:X>Java app 


En el constructor de a... 
En el constructor de b... 


Ahora supongamos que se cambia el constructor de b para que acepte un 
parámetro: 


class a 
I 
ao 
I 


System.out.println("Enel constructor de a..."); 


class b extends a 
{ 
b(String e) 
f 
systam.out.println("En el constructor String de b..."); 
Syaten.cut.printinia)f 


public class app 


{ 
public static void main(String[] args) 


( 
b obj = new b("iHola desde Java!"); 


1 


En este caso, se llama a los constructores de ambas clases, a y b: 


C:\>java app 

En el constructor de a... 

En el constructor String de b.. 
¡Hola desde Java! 


Un constructor sin parámetros se llama constructor por defecto de una 
clase, ya que Java lo llamará automáticamente cuando se instancien subclases 
de esa clase, a menos que se haga otro tipo de peticiones. ¿Qué significa eso? 
Supongamos que se añade otro constructor a la clase a para gestionar las 
cadenas (esto se llama sobrecarga, y lo veremos más tarde en este capítulo): 


class a 


{ 


System.out.println("Enel constructor de d..."); 


a(String S) 

í 
~ystem.out.println(~~eal constructor string de a); 
System. out .print1n (s); 


1 


Ahora digamos que se quiere llamar al constructor de la clase a con el 
parámetro String en lugar de llamar a los constructores por defecto. ¿Cómo se 
hace esto? Se llama al método super del constructor de la clase b, como 
sigue: 


class a 
{ 
a() 


( 


System.out.println("Enel constructor de a..."); 


1 


a(String S) 
( 


System.out.println(-el constructor String de a..."); 
System.out.println(s); 


class b extends a 


b(String S) 
( 
super (s); 
System.out.println("Enel constructor de b..."); 


public class app 
I 


public static void main(String[l1 args) 


{ 


b obj = new b("iHola desde Java!"); 
1 
ki 


Ahora cuando se instancia un objeto de la clase b, se llama al constructor 
de la clase a que tiene un parámetro String, no al constructor por defecto: 

C:i>java app 

En el constructor String de a... 

¡Hola desde Java! 


En el constructor String de b... 
¡Hola desde Java! 


¿Por qué se llama al constructor que tiene un parámetro String en la clase 
a y no al constructor por defecto de la clase a? La razón es sencilla, Java ve 
que se está usando el método super para llamar al método de la superclase: 


class b extends a 


{ 
b (String S) 


{ 
super (e); 
System.out.println("En el constructor String de b..."); 
System.out.println(s); 


4 


Si se usa super para llamar al constructor de una superclase, la línea en la 
que se hace esto debe ser la primera del constructor, que es donde Java lo 
buscará (si es cualquier otra línea distinta de la primera, Java lo ignora). 


Crear multiniveles de herencia 


"Entonces", dice el programador novato, "¿se pueden crear subclases de 
subclases?" "Sí", le dice. "Y ¿se puede crear subclases de subclases de 
subclases?" " Sí", le dice. PN está dispuesto a continuar y pregunta, "y 
¿puedo yo...?" "¿Qué tal un café?", le dice. 

En el primer punto de este capítulo, se creó una clase llamada "vehículo" y 


una subclase de "vehículo" llamada "coche": 


class vehiculo 


( 
public void starto 


( 


" 
System.out.println("Arrancar... ); 


1 


class coche extends vehiculo 


public void drive0 


( 


" 
system.out.println("Conducir... 1; 
4 
4 


Esa jerarquía de clases sólo incluía dos niveles, la superclase y la subclase, 


pero se puede profundizar más. Digamos, por ejemplo, que tenemos una 
nueva clase, avión, que es una subclase de vehículo y añade un método 


llamadofly: 


class avion extends vehiculo 


{ 
public void fly() 


( ' 
System.out.println("Volar....); 


4 
1 


Hay todo tipo de aviones, y derivará dos clases de "avión": whirlybird, 
que define un nuevo método llamado whirl, y jet, que define un método 
llamado zoom: 


class whirlybird extends avion 


I 
public void whir10 


I " 


System.out.println("Girar... ); 


4 


class jet extends avion 


( 
public void zoom () 


{ 


System. out .print1n ("Subir verticalmente..."); 


1 
1 


Esta es la jerarquía de la clase ahora: 


vehiculo 
t coche 


avion 
1 whi rlybird 
] jet 


Ahora podemos instanciar objetos de estas clases, como se hace en este 
ejemplo en el que se crean objetos de la clase "coche" y jet: 


public class app 
{ 


public static void main(String[] args) 
I 
System.out.println("Crear un coche..."); 
coche c = new coche (); 
c.starto; 
c.drive(); 


System.out.println0 ; 
System.out.println("Crear un jet..."); 
jet j = new jet (); 

j.startO; 

j.f1y0; 

j.zoom0; 


1 
Esta es la salida del código: 


C:X>java app 
Crear un coche... 
Arrancar... 
Conducir... 


Crear un jet... 
Arrancar... 

Volar... 

Subir verticalmente... 


Gestionar multiniveles de constructores 


"¡Eh!" dice el programador novato. "¿Está en plan gracioso Java otra 
vez?" le pregunta. "Sí", dice el PN, "he creado cuatro niveles de subclases, 
clases de la a a la d, donde a es la superclase de la que deriva todo. Tiene 
sentido pensar que el constructor de d será al que se llame primero, luego al 
de c, luego al de b y después al de a, ¿correcto?" "No", le dice, "Java los llama 
exactamente en orden inverso". "Sabía que estaría de mi lado", dice el PN. 

Miremos en un ejemplo el uso de los multiniveles de constructores. Aquí, 
implementaremos el programa del programador novato con cuatro niveles de 
subclasificación, empezando con la clase a: 


System.out.println ("Construcción de a..."); 


class b extends a 
{ 

b 0 

{ 


System.out.println("Construcción de b..."); 


class c extends b 


System.out.println ("Construcción de c..."); 


class d extends c 
( 

d() 

{ 


System.out.println ("Construcción de d..."); 


1 


Después, se creará un objeto de la clase d, la última clase de la cadena de 
subclases: 


public class app 
( 
public static void rnain (String|! args) 
{ 
d obj = new a(); 
1 
1 


Esto es lo que se ve cuando se ejecuta el código: 


C:\>java app 

Construcción de 
Construcción de 
Construcción de 
Construcción de 


aarp 


En otras palabras, llamó primero al constructor de a, después al de b, 
luego al de c y después al de d, no en el orden inverso como se podía esperar. 
¿Por qué Java lo hace de esta forma? Porque cuando se crean subclases, se 


procede desde lo general a lo específico, lo que significa que la clase a no 
sabe nada de la clase b, ésta no sabe nada de la c y así sucesivamente. Por esa 
razón, Java llama al constructor de la subclase original primero, después al 
siguiente, etc. Como la clase b sabe de la clase a, se podría contar con tener 
ciertas partes de a inicializadas antes de completar su inicialización, y lo 
mismo para la clase c respecto a la b, etc. 

Además, observe que se pueden pasar parámetros a los múltiples niveles 
de las formas que se vieron en el punto correspondiente en este capítulo. Sin 
embargo, todos los constructores de la cadena de subclases deben llamarse en 
orden ascendente. 


Sobrescritura de métodos 


"Bien", dice el programador novato, "creía que podía usar la clase Button 
de Java en mi nuevo programa, pero quería crear un método llamadogetlabel, 
y la clase Button ya tiene un método con ese nombre". "No hay problema", le 
dice, "puede sobrescribir el método getLabel de la clase Button con una 
nueva implementación de ese método". "¿Puedo hacer eso?" pregunta PN. 

En el último capítulo, vimos que se puede sobrecargar métodos con dife- 
rentes implementaciones que tienen diferentes listas de parámetros. También 
se puede sobrecargar métodos que se heredan de una superclase, lo que quiere 
decir que los sustituye con una nueva versión. 

En el ejemplo siguiente, empezaremos con una clase base general llamada 
animal que tiene un método, breathe. Cuando se llama a breathe, se visualiza 
"Respirar... "Este es el código: 


class animal 


{ 


public void breatheo 


{ 


System.out.println("Recpirar... "j $ 


1 


Ahora, supongamos que se quiere derivar una nueva clase de "animal" 
llamada "pez". Cuando se prueba el método breathe en la clase "pez", sin 
embargo, se ve que se visualiza "Respirar...". Se decide que sería mejor 
visualizar "Burbujear. ..".Para hacerlo, se puede sobrescribir el método breathe 
en la clase "pez" simplemente definiendo una nueva versión con la misma 


lista de parámetros: 


class animal 
I 
public void breathe() 
c 
System. ~ut .println(-Respirar..."); 


class pez extends animal 
I 
public void breathe () 


{ 
System.out .println ("Burbujear..."); 
1 
1 


Ahora se puede instanciar nuevos objetos de las clases "animal" y "pez" y 
llamar a sus métodos breathe como sigue: 


public class app 
I 
public static void main(String[l1 args) 


{ 
System.out.println("Crear un animal..."); 
animal a = new animal (); 


a.breathe():; 


System.out.println(); 
System.out.println("Crear un pez..."); 
pez f = new pez(): 

f.breathe(); 


1 


Fi 
Esta es la salida del código, mostrando que el método breathe está sobre- 
cargado: 
C:\>java app 


Crear un animal. 
Respirar... 


Crear un pez... 
Burbujear... 


Acceso a los miembros sobrescritos 


"Bien", dice el programador novato, "creo que he encontrado un problema' 
que nadie más ha encontrado en Java". "Ah ¿sí?", le pregunta. "Sí", dice PN, 
"he sobrescrito un método de una superclase, y funciona bien la mayor parte 
del tiempo, pero algunas veces necesito acceder al método original sobrescri- 


to". "Es un problema común”, le dice, 
clavesuper". 

Se puede usar super igual que se usa la palabra clave this, excepto que 
super no se refiere al objeto actual, sino a su superclase. Por ejemplo, eche- 
mos un vistazo al código del punto anterior en el que la clase "pez" es una 
subclase de la clase "animal" y sobrescribe el método breathe para que se 
visualice "Burbujear ..."en lugar de "Respirar...”: 


y se puede resolver con la palabra 


class animal 


{ 
public void breathe (| 


class pez extends animal 


{ 
public void breathe () 


{ 


System.out.println("Burbujear...o ); 


Ahora, sin embargo, supongamos que se da cuenta de que cierto tipo de 
peces pueden respirar como los animales, por lo que se añade un nuevo 
método a la clase pez, newbreathe. En este método, le gustaría utilizar el 
método breathe de la superclase, y se puede hacer eso con la palabra clave 
super, como sigue: 


class animal 


{ 
public void breathe0 


{ 
System.out .print1n ("Respirar ... "1; 


1 


class pez extends animal 
I 
public void breathe () 
( 
System.out.println( Burbujear...'!; 


1 


public void newbreathe () 
( 
super.breathe0; 


1 


Ahora se puede instanciar objetos de las clases "animal" y "pez" y usar el" 
método newbreathe, como sigue: 


public class app 
( 


public static void main (String[l args) 

( 
System. out .println("Crear un animal...-); 
animal a = new animal (); 
a.breathe():; 


System.out .println("Crear un pez..."); 
pez 1f = new pez(); 


LLwWwbrEoa CA 


Este es el resultado del código: 


C:i>java app 
Crear un animal... 
Respirar... 


Crear un pez... 
Respirar... 


Usar variables de superclase con objetos 
de subclases 


7 
El zar de la Programación Exacta (ZPE) aparece y dice, "En C++, se puede 


asignar una referencia a un objeto de una subclase a un tipo de variable de una 
superclase. ¿Se puede hacer eso en Java?" El programador novato dice "¿Lo 
hace por mí?" "Sí", le responde el ZPE. 

Un aspecto interesante de la programación orientada a objetos (POO) en” 
Java, que pondremos a funcionar en el siguiente punto, es que se puede 
asignar una referencia a un objeto de subclase a un tipo de variable de una 
superclase. Digamos, por ejemplo, que la clase a es la superclase de b y tiene 
una variable de la clase a. Esto significa que se puede asignar referencias de 
objetos de clase b a esa variable, así como referencia a objetos de la clase a. 


Veamos un ejemplo. Aquí usaremos el multinivel de la jerarquía de clases 
que ya vimos en este capítulo: 


class vehiculo 


( 
public void start () 


class coche extends vehiculo 
I 

public void drive0 

I 


System.out.println("Conducir ... ); 
1 


class avion extends vehiculo 
I 
public void fly () 
( 
System.out .println("Volar..."); 
1 
1 


class whirlybird extends avion 
I 

public void whirl() 

( 


System.out.println("Girar... ); 


1 


class jet extends avion 
{ 

public void zoom() 

( 


Syctem. out .print1n ("Subir verticalmente.. ."); 


1 
1 


Por ejemplo, para crear nuevos objetos de las clases 
puede usar este código: 


public class app 


I 
public static void main (String[] args) 
( 
System.out.println("Crearun coche..."); 
car c = new car (); 
c.starto; 
c.drive0; 
System.out.println0; 
System.out.println("Crear un jet..."); 
jet j = new jeto; 
j.start0; 
1 
1 


"coche" y jet, se 


Sin embargo, también se puede asignar el nuevo objeto jet a la variable de 
clase vehiculo, como sigue: 


public class app 


( 
public static void main(String[J args) 
I 
System.out.println("Crear un coche..."); 
coche c = new coche (); 
c start ():; 
c.drive0; 


System.out.println0; 
System.out.println("Crear un jet..."); 
vehiculo j = new jetoO0; 


Esta es la salida del código: 


C:i>java app 
Crear un coche... 
Arrancar... 
Conducir... 


Crear un jet... 
Arrancar... 


Ahora se comentaron las líneas j.Jly() y j.zoom() porque esos métodos” 
están definidos en las clases "avión" y jet, que son subclases de "vehículo", lo 
que quiere decir que esos métodos no se pueden usar con una variable de la 
clase "vehículo". En general, una variable de objeto, a, sólo permitirá acceder 
a los elementos de su propia clase, no necesariamente a todos los miembros; 
en particular, no se podrá acceder a ningún miembro que no lo sea de la clase a. 


Dispatching dinámico de métodos (Polimorfismo 
en tiempo de ejecución) 


"Vaya", dice el programador novato, "tengo otro problema. Mi programa 
de dibujo crea objetos de las clases triángulo, cuadrado y círculo, cada una de 
ellas tiene un método Dibujar, pero no estoy seguro del tipo de objeto que el 
usuario querrá hacer hasta que el programa no se ejecute. ¿Tendré que escri- 
bir el código principal del programa tres veces, una por cada tipo de objeto?" 


"No del todo", le dice. "Puede usar el polimorfismo en tiempo de ejecución”. 
"¿Cómo?" contesta PN. 

El polimorfismo en tiempo de ejecución, llamado, en Java, dispatch diná- 
mico de métodos, permite esperar hasta que el programa se esté realmente 
ejecutando para especificar el tipo de objeto que estará en una variable parti- 
cular del objeto. Esto quiere decir que, en el caso del programador novato, 
puede escribir su código llamando al método Dibujar en varias variables y 
decidir el tipo de objeto, triángulo, cuadrado o círculo, que está almacenado 
en esas variables en tiempo de ejecución. 

Como vimos en la sección anterior, se puede asignar una referencia a un 
objeto de subclase a un tipo de variable de una superclase. Puede que se esté 
preguntando porqué Java, que es tan estricto con el tipo de datos, permite 
hacer esto. La respuesta es soportar el polimorfismo en tiempo de ejecu- 
ción. 

En el siguiente ejemplo se clarifica todo esto. En este caso, se creará una 
superclase llamada a, una subclase de a llamada b, una subclase de b llamada 
c y una subclase de c llamada d, cada una de las cuales tiene un métodoprint: 


class a 
1 
public void print () 
1 
System.out.println("Aquí está a..."); 


class b extends a 


( 
public void print () 


1 
System.out.println("Aquí está b..."); 


class c extends a 

I 
public void print () 
1 


System.out.println("Aquí está c..."); 


} 


class d extends a 
( 
public void print () 
I 
System.out.println("Aquí está d..."); 


Ahora se puede crear una referencia al objeto de cada tipo de clase: 


public class app 
I 
public static void main(String[l1 args) 
( 
a al = new a(); 
b bl new bO; 
c cl = œw c0; 
d dl = new do; 


Para mostrar cómo funciona el polirnorfisrno en tiempo de ejecución, 
crearemos además una variable llamada aref que gestiona una referencia a un 
objeto de la clase a: 


public class app 
( 


public static void main (String[l args) 


{ 


a al = new a(); 
b bl = new b0; 
c cl = newc0; 
d dl = new do; 
a aref; 
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Ahora, se puede hacer referencia a los objetos de todas las clases diferen- 
tes en aref, y cuando se llame al método print, el método print de la clase 
correspondiente será el llamado: 


public class app 
I 
public static void main (String[l args) 


I 


a al = new a(); 
b bl = new b0; 
c cl = newc0; 
d dl = new d() 5 
a aref; 
aref = al; 


aref .print ()5 


aref = bl; 
aref .print () 5 


aref = el; 


aref .print () 5 


aref = cil; 
aref .print (15 


1 
Este es el resultado del código: 


C:i>java app 
- qu éstá 
~ quéstá 
Aquí está 
Aquí está 


ao Tp 


Usando el polimorfismo en tiempo de ejecución, se puede escribir código 
que funcionará con diferentes tipos de objetos y se decidirá el tipo de objeto 
actual en tiempo de ejecución. Observe que todavía se aplican las restriccio- 
nes mencionadas en el punto anterior: una variable de objeto, a, sólo permiti- 
rá acceder a los elementos que son miembros de su propia clase, no 
necesariamente a todos los miembros de la variable objeto que gestiona, en 
particular, no se podrá acceder a los miembros que no son miembros de la 
clase de a. 


Crear clases abstractas 


El programador novato aparece. "¡Ese Johnson!", dice PN. "¿Qué ocu- 
rre?", le pregunta. "Ese Johnson estaba utilizando una de mis clases que es 
necesario personalizar antes de que se pueda usar, pero no lo hizo. Por lo 
tanto, no funcionó, ¡justo allí, delante del gran jefe!” "Bien", le dice, "la 
próxima vez, haga una clase abstracta, y ese Johnson tendrá que personalizarla”. 

Cuando se escriben clases, se pueden ejecutar casos donde sólo se pueda 
proporcionar código general, y es necesario que el desarrollador que crea 
subclase de la clase las personalice. Para asegurarse de que el desarrollador 
personalice el código, se puede hacer que el método sea abstracto, lo que 
significa que el desarrollador tendrá que sobrescribir el método, de lo contra- 
rio Java se quejará. Para hacer un método abstracto, se usa la palabra clave 
abstract. Si se hace algún método abstracto en una clase, también deberá 
serlo la clase. 

He aquí un ejemplo. En este caso, se crea una clase llamada a que tiene un 
método llamado print, que visualiza una cadena y obtiene la cadena para 
visualizar llamando al método getData: 


String getData0; 


public void printo0 
I 
System.out.println(getData0 Í; 


1 


Observe que no hay ninguna implementación del método getData porque 
se quiere que los desarrolladores especifiquen qué datos van a visualizar. 
Para asegurarse de que saben que deben proporcionar una implementación 
del método getData, se puede hacer que sea abstracto, lo que significa que 
también la clase debe ser abstracta: 


abstract class a 


( 
abstract String getData0; 


public void printo0 


( 
System.out.println(getData0); 
4 
1 


Ahora, cuando se crea una subclase de a, hay que proporcionar un; 
implementación de getData, como sigue: 


class b extends a 


( 
String getData0 


ll 
return n;Hola desde Javal*; 


1 


Así es como funcionaría la subclase (observe que no se puede instancia7 
directamente un abstracto): 


public class app 
{ 


public static void main (String[l args) 
I 
b bl = new b0; 


bi. printi} i 


Este es el resultado del código: 


C:\>java app 
¡Hola desde Java! 


Abandonar la sobrescritura con final 


El programador novato dice, "¡Ese maldito Johnson!" "¿Qué ocurre?", le 
pregunta. "Ese Johnson sobrescribió el método dibujar de mi clase painter y 
lo lió todo", se queja PN. "No se preocupe, PN", le dice, "puede marcar ese 
método como final, y nadie puede sobrescribirlo". "¡Bien! "dice PN. 

Anteriormente en este capítulo, vimos un ejemplo en el que la clase "pez" 
sobrescribía el método breathe de la clase "animal": 


class animal 


{ 


void breathe () 
{ 
System.out.println("Respirar... ); 
1 
1 


class pez extends animal 
{ 
public void breatheo 


{ 


" 
System.out.println("Burbujear... ); 


1 


Si por alguna razón no se quiere permitir la sobrescritura del método 
breathe, se le puede declarar final, como sigue: 


class animal 
I 
final void breathe0 
{ 
System.out.println("Recpirar ... ) 
1 
1 


class pez extends animal 
{ 
public void breathe () 
{ 
System.out .println("Burbujear...-"):; 


1 


Ahora, supongamos que se intenta usar estas clases en algún código: 


public class app 
( 
public static void main (String[] args) 
{ 
System.out.println("Crear un animal..."); 
animal a = new animalo; 
a.breathe () ; 


System.out.println(); 


System.out.println('Crear un pez..."); 
pez f = new pez(); 
f.breathe():; 


1 


Java avisará de que no se puede sobrescribir breathe, de la siguiente forma? 


C:il>javac app.jJava -deprecation 
app.Java:11: The method void breatheo declared in class pez cannot 
override the final method of the same signature declared in class animal. 
Final methods cannot be overridden. 

public void breathe() 


A 


1 error 


Abandonar la herencia con final 
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Se puede prevenir la creación de subclases de una clase declarando toda la 
clase comofinal, como se ve a continuación: 


final class animal 
{ 
public void breathe () 
( 
System.out .printl1n ("Respirar ... ); 
} 
} 


class pez extends animal 


( 
public void breatheo 


( 


System.out.println("Burbujear... ); 


) 
1 


public class app 


{ 
public static void main(StringCl args) 


RJ 
iN 
Fg 


System.out.println("Crear un animal..."); 
animal a = new animal (1; 
a.breatheí) : 


System.out.println(); 


System.out.println("Crear un pez..."); 
pez f = new pez (): 
f.breatheí) ; 


1 


Esto es lo que ocurre cuando se intenta ejecutar este código: 


app. Java:g: Can't subclass final classes: class animal 
class pez extends animal 


A 


1 error 


Crear constantes con final 


En los dos puntos anteriores, se mostró dos formas de usar final: para 
prevenir que un método sea sobrescrito y para crear subclases de una clase. 
En Java, hay otro uso definal: se puede usar para declarar constantes. 

Este es un ejemplo en el que se convierte una variable en constante con 
final y después se le intenta asignar un valor: 


public class app 
{ 


public static void main (String[] args) 


I 


final int a = 5; 


a = Ef 


Esto es lo que el compilador de Java diría: 


C:X> javac app.java -deprecation 
app. jJava:7: Can't assign a value to a final variable: a 
a= 6; 


A 


1 error 


Relación es-a frente a tiene-a 


El zar de la Programación Exacta llega y dice, "En C++, en la herencia se 
pueden tener relaciones es-a y tiene-a”. "También en Java", le dice. 


Se pueden ver los términos es-a y tiene-a al trabajar con la herencial 
porque especifican dos de las formas en que las clases pueden relacionarse. 
La herencia estándar es en la que generalmente se piensa en términos de una 
relación es-a, como en el ejemplo siguiente. En este caso, la clase a extiende 
la clase b, por lo que se puede decir que la clase a es-a b: 


class a extends b 
print (); 


class b 


{ 


void printo 


( 


System.out.println("Esto viene de la clase b..."); 


1 


public class app 
{ 


public static void main(String[] args) 
I 


a obj = new a(); 


1 


Cuando se llama al método print de a, realmente se está llamando a7 
método print de a heredado de b, y es este método quien hace la visualiza- 
ción: 

C:\>java app 


Esto viene de la clase b... 


Por otro lado, en una relación tiene-a, un objeto incluye una referencia 7 
otro, como en este caso, en el que los objetos de la clase a incluirán un objeto 
interno de la clase b: 


class a 


( 


bl = new b0; 
bl .print () 5 


class b 
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void print (1 


{ 
System.out.println("Esto viene de la clase b..."); 


1 
} 


public class app 


{ 
public static void main(String[] args) 


t 


a obj = new a(); 


1 
) 


Ahora, el método print de la clase b está accesible desde el objeto bl del 
objeto de la clase a: 


C:\>java app 
Esto viene de la clase b.. 


~a'clas©bjectde Java 


"Lo que quiero", dice el programador novato, "es escribir una clase senci- 
lla, sin herencia ni nada y..." "Demasiado tarde”, le dice. "En Java, todas las 
clases son subclases de una clase maestra, java.lang.Object, por lo que en 
todo está involucrada la herencia". 

En Java, toda clase se deriva automáticamente de la clasejava.lang. Object, 
y hay ciertas ventajas de saber esto, ya que significa que todos los objetos ya 
han heredado algunos métodos que están preparados para usarlos. Los méto- 
dos de la clase Object aparecen en la tabla 5.2. 

Este es un ejemplo en el que se usa el método getClass para determinar la 
clase de una referencia a un objeto en una variable de superclase; esto es útil 
porque una variable de superclase puede gestionar referencias a objetos de 
cualquiera de sus subclases. 

Empezamos con una superclase llamada a y tres subclases: b, c y d. El 
métodoprintde cada una de estas clases visualiza el nombre de la clase. Este 
es el código: 


class a 
I 
public void print () 
1 
System.out.println("Aquí está a..."); 
1 
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Tabla 5.2. Los métodos de la clase Obiect de Java. 


Constructores Descripción 


protected Object clone() Proporciona una copia del objeto. 
boolean equals(Object obj) Indica si otro objeto es igual a éste. 


| Protected void finalize() El recolector de basura lo llama en un objeto, 
cuando la coleccióngarbagese va a deshacer 
del objeto. 
Class getClass() Proporciona la clase de un objeto en tiempo de 
ejecución. 
int hashCode() Proporciona un valorhashcode para el objeto. 
void notify() Activa un hilo (thread) sencillo que está espe- 


rando en este objeto. 


| void notifyAll() Activa todos los hilos (threads) que están es- 
perando en este objeto. 


String toString() Proporciona una representación encadena del 
objeto. 


void wait() Hace que el hilo (thread) actual espere hasta 
que otro invoque el métodonotifyo el notifyAl1. 


void wait(tong timeout) Hace que el hilo (thread) actual espere hasta 
que otro invoque el métodonotify o el notifyAll 
O pase una cierta cantidad de tiempo. 


void wait(tong timeout, Hace que el hilo (thread) actual espere hasta 
intnanos) que otro invoque el métodonotify o el notifyAll 
para este objeto, algún otro hilo interrumpa a 
éste o pase una cierta cantidad de tiempo. 


class b extends a 
{ 
public void print () 
( 
System.out.println("Aquí está b..."); 
1 
1 


class c extends a 
{ 
public void print () 
I 
Systern.out.println("Aquí está c..."); 
1 


class d extends a 


{ 
public void printo 


{ 
Systern.out.println("Agquíestá d..."); 


Lo siguiente, es crear una instancia de cada clase y una variable de la clase 
a llamada are8 


public class app 
{ 


public static void mainiStringI] args) 


{ 


a al = new a0; 
b bl = new b0; 
c cl =newco; 
d dl = new do; 
a aref; 


Ahora, se puede determinar la clase del objeto en aref, no importa cuál sea 
la subclase: 


public class app 
{ 


public static void main (String[] args) 


I 


a al = new a(); 
b þpi-= ner b0 
c cl = new c(); 
d dl = new do; 
a aref; 
aref = al: 


System.out.println("Ahora, la clasedearefes " + aref.getClass0); 
Aref. print ()5 


aref = bl: 
System.out.println("Ahora. Jlaclasedearef es 
Aref .print ()5 


+ aref.getClass0); 


aref = cl; 
System.out.println("Ahora, la clase de arefes "+aref. getClasS0); 
Aref. print ()2 


aref = dl: 
System.out.println("Ahora, laclasedearefes 
Aref. print () £ 


" 


+ aref.getClass ()); 


Este es el resultado: 


C:i>java app 

Ahora, la clase de aref es a 
Aquí está a... 

Ahora, la clase de aref es b 
Aquí está b... 

Ahora, la clase de aref es c 
Aquí está c... 

Ahora, la clase de aref£ es d 
Aquí está d... 


Como se puede observar, los métodos construidos en cada objeto, como" 
getclass, pueden ser muy útiles. 


Usar interfaces para herencia múltiple 


"Hmm", dice el programador novato, "tengo una clase llamada "animal" y 
una clase totalmente separada llamada "mineral" y quiero heredar de ambas 
clases al mismo tiempo para crear algo totalmente nuevo". "Lo siento, " le 
dice, "Java no soporta la herencia múltiple directamente, tendrá que hacer 
que una de esas clases sea una interfaz". P 

En otros lenguajes, como C++, una clase puede heredar de múltinkæc 
clases de una vez, pero esta técnica no funciona en Java directamentt:, ES 
decir, sólo se puede usar, de una vez, la palabra clave extends con una clase. 
Por lo tanto, no se puede hacer esto: 


class a extends b, c //;Nofuncionará! 


{ 


Sin embargo, hay dos formas de implementar la herencia múltipleen ~ ava; ~ 
La primera es usar herencia sencilla por etapas (funcionará para las clases de 
las que se quiere heredar), como sigue: 


class c 


I 


class b extends c 


( 


class a extends b 


I 


La otra manera es usar interfaces. Las interfaces empezarán a ser impor- 
tantes en el siguiente capítulo, por lo tanto, aquí sólo haremos una introduc- 
ción. 

Una interfaz especifica la forma de sus métodos pero no da ningún detalle 
de su implementación; por lo que se puede pensar en ella como la declaración 
de una clase. Como veremos más tarde en el libro, se pueden crear interfaces 
con la palabra clave interface: 


interface c 


I 


interface b 


I 


Ahora, se pueden usar estas dos interfaces con la palabra clave implements: 


class a implements b, c 


I 


Dado que las interfaces declaran pero no definen métodos, es labor de 
cada uno implementar los métodos de las interfaces. Por ejemplo, en la 
applet que se mostró al principio del capítulo, se implementó la interfaz de 
JavaActionListener para gestionar los clics de los botones (se verán todos los 
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detalles de las applets en el siguiente capítulo). Esa interfaz declara un 
método, actiopnerformed, que se define como sigue: 


import Java.applet.Applet; 
import Java.awt.*; 
import java.awt.event.*; 


public class clicker extends Applet implements ActionListener C 


TextField textl; 
Button buttonl; 


public void init()I 
textl = new TextField(20); 
add (text1); 
buttonl = new Button ("iHacer clic aquí!"); 
add (button1); 
buttonl.add-ctionListener (this); 


public void action-erformed (ActionEvent event) C 
String msg = new string("Bienvenid0 a Javam); 
ifierent.getBourca[] == butbtoni! i 
Texti,.,petTent(mag ij] 


j 


Si no se define el método actionperforrned, el cornpilador de Java dará 3 
mensaje como este: 


C:X>javac clicker.java -deprecation 

clicker.java:5: class clicker must be declared abstract. It does non 
define 

void actionPerformed (java.awt.event.ActionEvent) from interface 

java.awt.event.ActionListener. 

public class clicker extends Applet implements ActionListener { 


1 error 


os 
Se pueden implementar tantas interfaces como se quiera, como en este 


ejemplo, en el que se implementa la interfaz ActionListener para los clics de 
los botones y las interfaces MouseListener y MouseMotionListener para tra- 
bajar con el ratón: 


import Java.awt.Graphics; 
import java.awt.'; 
import jJava.awt.event.*; 


import java.applet.Applet; 


public class dauber extends Applet implements -ctionListener, 
MouseListener, MouseMotionlListener ( 


Button buttonDraw, buttonline, buttonoval, buttonkRect, 


point ptsll = new Point[10001; 
point ptAnchor, ptDrawTo, ptOldAnchor, ptOldDrawTo; 
int ptindex = 0; 


Crear clases internas 


"De acuerdo", dice el programador novato, "ahora soy un experto. ¿Hay 
algo más sobre clases que no sepa?" Usted sonríe y dice, "Bastante. Por 
ejemplo, ¿qué sabe de las clases internas?" "¿Qué clases?", pregunta PN. 

Al empezar en 1.1, se podían anidar definiciones de clases unas dentro de 
otras. Las clases anidadas pueden ser estáticas o no estáticas; sin embargo, 
las clases estáticas no pueden hacer referencia a los miembros de las clases 
que tiene en su interior directamente, sino que deben instanciar y usar un 
objeto en su lugar, por lo que con frecuencia no se usan. Las clases internas, 
por otro lado, son clases anidadas no estáticas, y son bastante más populares 
por ser útiles en la gestión de eventos, como veremos en el siguiente capítulo. 

Esto es un ejemplo de clases internas; en esta clase, la clase b está definida 
en el interior de la clase a y se instancia un objeto de la clase b en el 
constructor de la clase a: 


class a 


( 
b ob3; 


ao 

I 
obj = new b0; 
obj .print ()5 


class b 


c 
public void printo 


( 


System.out.println("En el interior de b..."); 
1 


public class app 
( 


public static void main (String[l1 args) 


( 


a obj = new a(); 
1 
1 


Cuando se ejecuta este código, se instancia un objeto de la clase a, que 
instancia un objeto interno de la clase b y llama al métodoprint de ese objeto. 
Este es el resultado: 

C:\>java app 


En el interior de b... 


7 
Más allá de las clases internas, como se ha visto en este ejemplo, se 


pueden tener clases internas anónimas (sin nombre) (ver el siguiente punto 
para más detalles). 


Crear clases internas anónimas 


Un forma corta que es útil para trabajar con la gestión de eventos, es usa? 
clases internas anónimas. Las vamos a introducir aquí y las usaremos en el 
siguiente capítulo. Una clase interna anónima es aquella que no tiene nombre 
y se crea usando la siguiente sintaxis: 


new SuperType(constructor pararneters) 


( 
//métodos y datos 


1 


Aquí, SuperType es el nombre de una clase o interfaz de la que se estáfl 
creando subclases (se debe especificar un tipo de superclase cuando se crean 
clases internas anónimas), y se puede definir los métodos y los datos de las 
clases internas anónimas en un bloque de código. 

Veamos un ejemplo. En este caso, crearemos una clase interna anónima e? 
el interior de una nueva clase, clase a. Esta clase interna anónima subclasificará 
otra clase, clase b y definirá un método llamado print, al que se llamará 
inmediatamente: 


class a 
{ 
aí) 
( 
(new bí) (public void print () 
(System.out.println("iHola desde Java!");)]) .printo; 


class bI} 


Lo único que queda es crear un objeto de la clase a y llamar al constructor 
de esa clase: 


public class app 
( 


public static void main(String[] args) 


{ 


a obj = new a(); 
1 
1 


Este es el resultado del código: 


C:>java app 
¡Hola desde Java! 


En el siguiente capítulo, aprenderemos más sobre las clases internas anó- 
nimas. 


Ba 
ia 
[FE] 


ES AWT: Applets, 
aplicaciones 
gestión 

de eventos 


Hemos trabajado mucho con la sintaxis de Java para llegar a este punto, 
que es uno de los capítulos principales. Aquí empezaremos a trabajar con los 
programas de gráficos, las applets y las aplicaciones. Este capítulo introduce 
Java Abstract Windowing Toolkit (AWT), la forma original de Java para 
trabajar con gráficos. 

Ahora, AWT está complementado con el paquete Swing, que veremos 
dentro de unos cuantos capítulos. AWT proporciona la base para trabajar con 
gráficos en Java e incluso el paquete Swing está basado en él. 

En este capítulo, trabajaremos con AWT, creando applets y ventanas de 
aplicación. Antes de empezar, situaremos AWT en la historia. AWT fue 
desarrollado muy rápidamente para la primera release de Java, de hecho, en 
sólo seis semanas. Los desarrolladores del AWT original usaron una ventana 
para cada uno de sus componentes, es decir, para cada botón, cuadros de 
texto, casilla de activación, etc., y por lo tanto, tenían su propia ventana 
cuando al sistema operativo le interesaba. Esto producía un consumo consi- 
derable de los recursos del sistema cuando los programas llegaban a ser 
grandes. Recientemente, Sun introdujo el paquete Swing, en el que los com- 
ponentes se visualizan usando métodos gráficos de laappleto aplicación que 
los contiene, ellos no tienen sus propias ventanas del sistema operativo. Los 
componentes AWT se llaman componentes pesos pesados debido al uso 


significativo que hacen de los recursos del sistema y los componentes Swing 
se llaman componentes peso ligero, ya que no necesitan sus propias ventanas. 
¿Qué significa esto? Está claro que para Sun, Swing es el futuro. Hay más 
componentes Swing que AWT, y de hecho, hay un componente Swing para 
cada componente AWT. En el futuro, probablemente, Sun no ampliará el 
conjunto de componentes AWT mucho más, mientras que sí se espera que 
Swing crezca. Por otro lado, Swing, en sí mismo, está basado en AWT; las 
ventanas que Swing utiliza para visualizar sus componentes, es decir, venta- 
nas, marcos de ventanas, applets y diálogos, están todos ellos basados en 
cqntenedores AWT. AWT no va a desaparecer y para trabajar con Swing, se 
necesita AWT. Por esa razón, y porque gran parte del desarrollo está hecho 
con AWT, y más que habrá en el futuro, dedicaremos éste y los siguientes 
capítulos a AWT. Empezaremos con una visión de AWT en sí mismo. 


Abstract WindowingToolIkit 


No es una exageración decir que la aparición de Abstract Windowing 
Toolkit fue obligada tras la popularidad de Java. Se puede crear y visualizar 
botones, etiquetas, mentís, cuadros de lista desplegables, cuadros de texto y 
otros controles de la interfaz de usuario que se esperan utilizar en la progra- 
mación basada en ventanas utilizando AWT. Esta es una lista de las clases de 
AWT más populares: 


e Applet: Crea una applet. 

e Button: Crea un botón. 

e Canvas: Crea un área de trabajo en el que se puede dibujar. 
e Checkbox: Crea una casilla de activación. 

e Choice: Crea un control de opción. 

e Label: Crea una etiqueta. 

e Menu: Crea un menú. 

e ComboBox: Crea un cuadro de lista desplegable. 

e List: Crea un cuadro de lista. 

e Frame: Crea un marco para las ventanas de aplicación. 
e Dialog: Crea un cuadro de diálogo. 


e Panel: Crea un área de trabajo que puede tener otros controles. 


e PopupMenu: Crea un menú emergente. 

e RadioButton: Crea un botón de opción. 

e ScrollBar: Crea una barra de desplazamiento. 

e ScrollPane: Crea un cuadro de desplazamiento. 

e TextArea: Crea un área de texto de dos dimensiones. 


e TextField: Crea un cuadro de texto de una dimensión (en otros lengua- 
jes se llama TextBox). 


e TextPane: Crea un área de texto. 


Window: Crea una ventana. 


La clase Applet de AWT es aquella en la que están basadas las applets 
AWT. Primero veremos esta clase. 


Applets 


¿Qué es exactamente una applet AWT? Una applet es un fichero de clase 
que se escribe específicamente para visualizar gráficos en la red Internet. Las 
applets se incluyen en las páginas Web utilizando la etiqueta HTML 
<APPLET>. Cuando se ejecutan en una página Web, las applets de Java se 
descargan automáticamente y el browser las ejecuta, visualizándose en el 
espacio de la página que se ha reservado para ellas. Pueden hacer de todo, 
desde trabajar con gráficos hasta visualizar animaciones, gestionar controles 
(como los que veremos funcionar en este capítulo), cuadros de texto y boto- 
nes. El uso de las applets hace que las páginas Web sean activas, no pasivas, 
que es su principal atracción. 

Cuando se trabaja con AWT, el proceso es como sigue: se crea una applet 
nueva, basándola en la clasejava.applet. Applet que, a su vez, está basada en 
la clase Component de AWT. He aquí un ejemplo que hemos visto antes y 
que haremos de nuevo en este capítulo. Este ejemplo visualiza el texto "¡Hola 
desde Java!" en una página Web: 

import java.applet.Applet; 


import java.awt.*:; 


public class applet extends Applet 


{ 
public void paint (Graphics g) 


{ 
g.drawString("iHola desde Java!", 60, 100); 
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La applet se compila en un fichero de bytecode con extensión ".class”. 
Una vez que se tiene este fichero, se sube a un proveedor de servicios de la 
red Internet (ISP). 

A una applet se le puede dar la misma protección que se daría a una página 
Web, asegurándose de que cualquiera pueda leer el fichero de la applet con 
extensión ”.class'(por ejemplo, en Unix, se debería dar a laappletel permiso 
644, que permite a todo el mundo leer el fichero). 


La nueva applet se puede insertar en una página Web con la etiqueta 
cAPPLET>, indicando el nombre del fichero con extensión "”.class Wsí como 
decirle al browser cuánto espacio (en pixels) requiere la applet. Esto es un 
ejemplo: 


<HTHL> 
<BODY> 


<CENTER> 

<APPLET 
CODE = "newApplet.classn 
WIOTH = 300 
HEIGHT = 200 

X 

<i APPLET? 

t CENTERS 


OO 
€ 'HTHL> 


En este caso, hemos establecido un espacio centrado de 300 x 200 pixels 
en una página Web que visualiza la applet, y decimos al browser que descar- 
gue el fichero newApplet.class y lo ejecute. En este capítulo, se incluirán 10s 
detalles de la etiqueta cCAPPLET>. Cuando el browser abra esta página, se 
visualizará la applet. 


Aplicaciones 


Las ventanas de aplicación AWT están basadas en la clase Frame de 
AWT, que crea una ventana con un marco que visualiza botones y un título. 
Este es un ejemplo que se verá más adelante en este capítulo. 

Al igual que la applet anterior, esta aplicación visualiza "¡Hola desde 
Java!" en una ventana: 


import java.awt.*; 
import java.awt.event.*; 


class AppFrame extends Frame 


{ 
public void paint (Graphics g) 
I 
g.drawString("iHola desde Java!", 60, 100); 
1 
1 


public class app 


{ 


public static void main(String |] args) 
1 
AppFrame f = new AppFrameO0; 
f.setsiza (200, 2001; 


f.addWindowListener (new WindowAdapterO0 ( public void 
windowClosing (WindowEvent e) (System.exit (O) ;1)) ; 


E.showlli 
| 


En este capítulo se verá, con más detalle, la creación de las ventanas de 
aplicación. 


Uno de los aspectos más importantes de la creación de applets y aplicacio- 
nes es permitir al usuario interactuar con el programa por medio de los 
eventos. Cuando el usuario ejecuta alguna acción, (hacer clic sobre un botón, 
cerrar una ventana, seleccionar un elemento de una lista o usar el ratón, por 
ejemplo), Java lo considera un evento. Gestionaremos eventos en el resto del 
libro y echaremos un vistazo al funcionamiento de la gestión de eventos en 
este capítulo. 

Para empezar a trabajar con eventos, introduciremos dos controles básicos 
en este capítulo: botones y cuadros de texto. El usuario puede utilizar el ratón 
para hacer clic sobre botones, lo que inicia alguna acción en el programa, 
como es escribir texto en un cuadro de texto. De hecho, el clic sobre los 
botones, es quizás el evento más básico que Java soporta. Para ver cómo 
funciona la gestión de eventos en Java, en este capítulo se crearán programas 
que soportan botones y cuadros de texto. En este capítulo aparecerán todos 
los detalles de estos controles. 

Ahora que ya se tiene una visión general de las applets, aplicaciones y 
gestión de eventos, ya es hora de entrar en detalles con la siguiente sección. 


Usar Abstract Windowing Toolkit 


"De acuerdo", dice el programador novato, "estoy preparado para trabajar 
con Abstract Windowing Toolkit. ¿Por dónde empezamos?" "Por la clase 
Component", le dice. "Cojamos un café y revisémoslo". 

La clase más básica de AWT es la clasejava.awt. Component, en la que se-' 
basan todos los componentes visuales de AWT. Por ejemplo, la clase Button, 
java.awt.Button, se deriva directamente de java. awt.Component. La clase 
java.awt. Component, se deriva directamente de la clase java. lang. Object, 
que se vio en el capítulo anterior. 

La clase Component incluye un gran número de métodos, muchos de ellos 
se verán en este y en los siguientes capítulos. Todos ellos se han incluido en 
la tabla 6.1 como referencia. Esta es una tabla larga, pero es bueno tenerla y 
regresar a ella más tarde como referencia. 


Tabla 6.1. Métodos de la clase Cornponent de AWT. 


Método Au 
boolean action(Event evento, Object Obsoleto. Se debería registrar el 
objeto) componente conActionListener. 


Metodo 


Acción 


voidadd(PopupMenurnenu-emergente) 


voidaddComponentListener(Compo- 
nentListener 1) 


void addFocusListener(FocusListener 1) 


voidaddInputMethodListener(input- 
MehtodListener 1) 


void addKeyListener(KeyListener 1) 
void addMouseListener(MouseL istenen) 


voidaddMouseMotionListener(Mouse- 
MotionListener 1) 


void addNotify() 


voidaddPropertyChangeListener(String 
propertyName, PropertyChangeListener 
listener) 


Rectangle bounds() 


int checklmage(1mage image, Inmage- 
Observer observer) 


protected AWTEvent coalesceEvents 
(AWTEventevento-existente, AWTE- 
ventnuevo-evento) 


boolean contains(int x, int y) 


boolean contains(Point p) 


Añade al componente el menú 
emergente indicado. 


Añade el ComponentListenerpa- 
ra recibir los eventos del com- 
ponente. 


Añade el FocusListener para 
recibir eventos de foco. 


Añade el inputMethodListener 
para recibir los eventos del rné- 


todo de entrada. 


Añade KeyListener para recibir 
eventos de clave. 


Añade el MouseListenerpara re- 
cibir eventos de ratón. 


Añade el MouseMotionListener 
para recibirlos eventos de rnovi- 
miento del ratón. 


Añade un componente visuali- 
zable para conectarlo a un re- 
curso de pantalla nativo. 


Añade un PropertyChangeLis- 
tener. 


Obsoleto. Sustituido por get- 
Bounds(). 


Obtiene el estado de la repre- 
sentación en pantalla de la ima- 
gen. 


Fusiona un evento para ser en- 
viado con otro evento. 


Comprueba si este componente | 
contiene el punto indicado. 


Comprueba si este componente 
contiene el punto indicado. 


Acción 


Método 


Image createlmage(1mageProducer 
productor) 


Image createlmage(int anchura, int 
altura) 
void deliverEvent(Event e) 


void disable() 


protected void disableEvents(1ong 
eventos-a-deshabilitar) 


| void dispatchEvent(A WTEvent e) 


void doLayout() 
void enable() 
void enable(boo1ean b) 


protected void enableEvents(1ong 
eventos—a-habilitar) 


voidenablelnpuiMethods(booleanenable) 


protected void fire PropertyChange 
(String propertyName, Objectvalor 
antiguo, Objectvalor-nuevo) 


float getAlignmentX() 
float getAlignmentY () 
Color getBackgrouna() 


Rectangle getBounds() 


Crea una imagen desde el pp- 
ductor de imagen indicado. 


Crea una imagen offscreen para 
usarla como doble buffer. 


Obsoleto. Sustituido por dis- 
patchEvent(AWTEvent e). 


Obsoleto. Sustituido porsetEna- 
bled(boo1ean). 


Deshabilita los eventos definidos 
por elevento indicado como pará- 
metro. 


Despacha un evento a este com- 
ponente o a uno de los subcom- 
ponentes. 


Hace que el gestor de esquemas 
ponga este componente. 


Obsoleto. Sustituido porsetEna- 
bled(boo1ean). 


Obsoleto. Sustituido porsetEna- 
bled(boo1ean). 


Habilitalos eventos definidos por 
el evento indicado para enviarlo 
a este componente. 


Habilita o deshabilita el soporte 
del método de entrada. 


Fija el soporte para reportar los 
cambios de las propiedades en- 
cerradas. 


Alineación a lo largo del eje x. 
Alineación a lo largo del eje y. 


Obtiene el color del fondo 8 
este componente. 


Establece los límites de esla 
componenteen un objeto rectán- 
gulo. 


Método Acción 


Rectangle getBounds(Rectang1e rv) Almacena los límites de este 
componente en rv y devuelve rv. 


ColorModelgeiColorModel() Obtiene la instancia de Color- 
Model usándolo para visualizar 
el componente. 


Component getComponentAt(int x, int y) Determina si el componente o 
uno de sus subcomponentes in- 
mediatoscontiene la localización 
(x, y) y obtiene el componente 
contenido. 


Componente getComponentAt(Pointp) Obtiene el componente o sub- 
componenteque contieneelpun- 


to indicado. 

ComponentOrientation getcomponent  Establecelaorientación sensible 

OrientationO al lenguaje para ordenar los ele- 
mentos o el texto dentro de este 
componente. 

Cursor gelCursor Obtiene el cursor puesto en el 
componente. 

DropTarget getDrop Target() Obtiene elDropTargetconectado 
a este componente. 

FontgetFont() Obtiene la fuente de este com- 
ponente. 

FonitMetrics getFontMetrics(FOnt fuente) Obtiene la métrica de la fuente 
indicada. 

Color getForegorund0O Obtiene el color de primer plano 
de este componente. 

Graphics getGraphicsO Crea un contexto gráfico para 
este componente. 

ini getHeigihi) Devuelve laaltura actual de este 
componente. 

InputContext getInpuiContext() Obtiene el contexto de entrada 


usado por este componente. 


InputMethodRequestsgetInputMethod- Obtiene el método de entrada 
Requests() solicitado. 


Método 


Locales gellLocale(] 


Point getLocale() 


Point getLocation(Point rv) 


Point getLocationOnScreen() 


Dimension getMaximumSize() 
Dimension getMinimumSize() 
String getiName() 


Container getParent() 


java.awt.peer.ComponentPeergetPeer() 


dimension getPreferredSize() 
Dimension getSize() 


Dimension getSize(Dimension rv) 


Toolkit getToolkit() 
Object getTreeLock() 


int get Width() 


Acción 


Obtiene el locale de este com- 
ponente. | 


Obtiene la ubicación de este com- 
ponente en la forma de un punto 
especificandolaesquina superior 
izquierda del componente. 


Almacena el origen x, y de este 
componente en rv y devuelve rv. 


Obtiene la localización de este 
componente en forma de punto, 
especificandola esquinasuperior 
izquierda del componente. 


Obtiene el tamaño máximo de 
este componente. 


Obtiene el tamaño mínimo de 
este componente. 


Obtiene el nombre del compo- 
nente. 


Obtiene el padre de este compo- 
nente. 


Obsoleto. Sustituido porboolean 
isDisplayable(. 

Obtiene el tamaño preferido de 
este componente. 


Obtiene el tamaño de este com- 
ponente de un objetoDimension. 


Almacena el ancho y el alto de 
este componente en rv y devuel- 
ve rv. 


Obtiene el kit de herramientas 
de este componente. 


Obtiene el objeto locking para el 
árbol de componente AWT. 


Obtienela anchura actual de este 
componente. 


Método 


int getX() 

intgetY() 

boolean gotFocus(Eventevento, 
Objectobjeto) 

boolean handleEvent(Eventevent0) 
boolean hasFocus() 

void hide() 

boolean imageUpdate(image img, int 
flags, intx, int y, int w, int h) 


boolean inside(int x int y) 


void invalidate() 


| boolean isDisplayable() 


boolean isDoubleBuffered() 


boolean isEnablea() 


boolean isFocustraversable() 


boolean isLightweight() 


boolean isOpaque() 


boolean isshowing() 


Accion 


Obtiene la coordenada actual x 
del componente original. 


Obtiene la coordenada actual y 
del componente original. 


Obsoleto. Sustituido porprocess- 
FocusEvent(FocusEvent). 


Obsoleto. Sustituidoporprocess- 
Event(A WTEvent). 


Verdadero si este componente 
tiene el foco del teclado. 


Obsoleto. Reemplazado porset- 
Visible(boo1ean). 


Repinta el componente cuando 
cambia la imagen. 


Obsoleto. Sustituido porcontains 
(int, inb). 


Invalida el componente. 


Determina si el componente se 
puede visualizar. 


Verdadero si este componente 
se pinta en unaimagenoffscreen 
que se copia en la pantalla más 
tarde. 


Indica si este componente está 
habilitado. 


Indica si el componente puede 
ser recorrido usandoT ab o Shift+ 
Tab. 


Indica si el componente es peso 
ligero. 


Verdadero si este componente 
es completamente opaco, falso 
por defecto. 


Determina si este componente 
es visible en pantalla. 


Pa 


Método Acción 


boolean ¡sValid() Determina si el componente es 
válido. 

boolean ¡isVisible() Determina si el componente de- 
bería ser visible cuando el padre 
lo es. 


Boolean keyDown(Event evt, intkey) Obsoleto. Reemplazado porpro- 
cessKeyEvent(KeyEvent). 


Boolean keyUp(Event evt, int key) Obsoleto. Reemplazado porpro- 
cessKeyEvent(KeyEveni). 


Voidlayout() Obsoleto. Reemplazado por do- 
Layout(). 


Voidlist() Imprime un listado de este com- 
ponente en el sistema de salida. 


Void list(PrintStream out) Imprime un listado de este com- 
ponente en el flujo de salida indi- 
cado. 


Void list(PrintStream out, intindentación) Imprime una lista, empezando 
en la indentación indicada, en el 
flujo de salida indicado. 


Void list(PrintWriter out) Imprime un listado en el print- 
Writerindicado. 


Void list(PrintWriter out, intindentación) Imprime una lista, empezando 
en la indentación indicada, en el 
PrintWriterindicado. 


Component locate(int x, inty) Obsoleto. Reemplazado porget- 
ComponentAt(int, int). 

Point location() Obsoleto. Reemplazado porget- 
Location(). 

Boolean lostFocus(Eventevento, Object Obsoleto. Reemplazado porpro- 

objeto) cessFocusEvent(FocusEvent). 

Dimension minimumsSize() Obsoleto. Reemplazado porget- 


MinimumSize(). 


Boolean mouseDown(Eventevento, Obsoleto. Reemplazado porpro- 
intx, inty) cessMouseEvent(MouseEvent). 


Método Acción 


| Boolean mouseDrag(Eventevento, i Obsoleto. Reemplazadoporpro- 
ntx inty) cessMouseMotionEvent(Mouse 
Event). 
| Boolean mouseEnter(Eventevento, Obsoleto. Reemplazadoporpro- 
intx, inty) cessMouseEvent(MouseEvent). 
Boolean mouseExit(Event evento, intx, Obsoleto. Reemplazadoporpro- 
inty) cessMouseEvent(MouseEvent). 
Boolean mouseMove(Eventevento, Obsoleto. Reemplazado porpro 
| ints int) essMouseMotionEvent(Mouse- 
Event). 
Boolean mouseUp(Eventevento, Obsoleto. Reemplazadoporpro- 
| intx, inty cessMouseEvent(MouseEven)). 
Void rnove(int x, int y) Obsoleto. Reemplazado porset- 
Location(int, int). 
Void nextFocus() Obsoleto. Reemplazado por 
transferFocus(). 
Void paint(Graphics 9) Pinta el componente. 
Void paintAll(Graphics 9) Pinta el componente y todos los 
subcomponentes. 
Protected String paramString() Obtiene una cadena que repre- 
senta el estado del componente. 
Boolean postEvent(Event e) Obsoleto. Reemplazado pordis- 
patchEvent(A WTEvent). 
Dimensionpreferredsizef) Obsoleto. Reemplazado porget- 
Preferredsizef). 
Boolean preparelmage(1mage irnage, Prepara una imagen para enviar 
ImageObserver observer) a ese componente. 


Boolean preparelmage(1rnageimagen, Prepara una imagen para enviar 
intanchura, intaltura, Imageobserver  aesecomponente, enla posición 


observador) indicada. 
Void print(Graphics 9) Imprime el componente. 
| VoidprintAll(Graphics 9) Imprime el componente y todos 


sus subcomponentes. 


Protected voidprocessCornponente-) Procesa los eventos del compo- 
Event(CornponentEvente nente que ocurren en este com- 


art 


Método Acción 


Protected void processEvent(A WT- 
Event e) 


Protected void processFocusEvent 
(FocusEvent e) 


Protected void processinputMethod- 
Event(1nputMethodEvente) 


Protected void processKeyEven1 
(KeyEvent e) 


Protected void processMouseEvent 
(MouseE vent e) 


Protected void processMouseMotion- 
Event(MOuseEvent e) 


Voidremove(MenuComponentpopup) 


VoidremoveComponentiListener 
(ComponentListener ĵ 


Void removeFocusListener(Focus- 
Listener ) 


Void removelnputMethodListener 


| (InputMethodListener ) 


ponente enviándolos a cual- 
quiera de los ComponenteLis- 
teners registrados. 


Procesalos eventos que ocurran 
en este componente. 


Procesa los eventos de foco que 
ocurran en este componente en- 
viándolos a cualquiera de los 
objetosFocusListenerregistrados. 


Procesa los eventos del método 
de entrada que ocurran en este 
componente enviándolos a cual- 
quiera de los objetos InputMe- 
thodListener registrados. 


Procesa los eventos clave que 

ocurran en este componente 
enviándolos a cualquiera de los 
objetos KeyListenerregistrados. 


Procesa los eventos de ratón 

que ocurran en este componente 
enviándolos a cualquiera de los 
objetosMouseListenerregistrados. 


Procesa los eventos de movi- 
miento de ratón que ocurran en 
este componente enviándolos a 
cualquiera de los objetos Mouse- 
MotionListenerregistrados. 


Retira del componente el menú 
emergente indicado. 


Retira el componente listener 
indicado para que no reciba más 
eventos de componente. 


Retira el focus listenerindicado 
para que no reciba más eventos 
de foco. 


Retira el método de entrada indi- 
cado para que no reciba más 
eventos del método Input. 


Método 


void removeKeyListener(KeyKistener 1) 


void removeMouseListerner(MouseLis- 
tener 1) 


void removeMouseMotionListener 
(MouseMotionListener 1) 


void removeNotify() 


void removePropertyChangeListener 
(PropertyChangeListenerlistener) 


void removePropertyChangeListener 
(String propertyName, PropertyChange 
Listener listener) 


void repaint() 


void repaint(int x, int y, int anchura, 
intaltura) 


void repaint(tong tm) 


void repaint(Tong tm, int x, int y, int an- 
chura, ¡nt altura) 


void requestFocus() 


void reshape(int x, int y, int anchura, 
int altura) 


void resize(Dimension d) 
void resize(intanchura, intaltura) 
void setBackground(Color c) 


void setBounds(int x, int y, int anchura, 
int altura) 


Acción 


Retira la key listener indicada 
para que no reciba más eventos 
de este tipo. 


Retira el listener de ratón indi- 
cado para que no reciba más 
eventos de ratón. 


Retira el listener de movimiento 
de ratónindicado para que no re- 
ciba más eventos de ratón de 
este tipo. 


Deshabilita la posibilidad de vi- 
sualizar el componente, destru- 
yendo su recurso de visualización 
nativo. 


Retira un PropertyChangeListe- 
ner. 


Retira un PropertyChangeListe- 
ner para una propiedad dada. 


Repinta el componente. 
Repinta el rectángulo indicado. 


Repinta el componente. 


Repinta el rectángulo indicado 
dentro de tm. 


Solicita el foco de entrada. 


Obsoleto. Reemplazadopor set- 
Bounds(int, int, int, int). 


Obsoleto. Reemplazado porset- 
Size(Dimensi0n). 


Obsoleto. Reemplazado porset- 
Size(int, int). 


Establece el color de fondo. 


Mueve y redimensionael compo- 
nente. 


Método 


void setComponentOr-entation(Com- 


ponentorientation o) 

void setCursor(Cursor cursor) 
void setDrop Target(Drop Target dt) 
void setEnabled(boo1ean b) 

void setFont(Font f) 

void setForeground(Co1orc) 


void setLocale (Locale 1) 
void setLocation(int x, int y) 


void setLocation(Point p) 
void setName(String nombre) 


voidsetSize(Dimension d) 


void setSize(int anchura, int altura) 


void setVisible(boolean b) 


void show() 
void show(boo1ean b) 


Dimension size() 


Acción 


Establece la orientaciónsensible 
alidioma que se usará para orde- 
nar los elementos o el texto. 


Establece la imagen del cursor | 


al cursor indicado. 


Asocia un DorpTarget con este 
componente. 


Habilita o deshabilita este com- 
ponente, dependiendo del valor 
del parárnetro - 


Fija la fuente del componente. 


Fija el color de primer plano del 
componente. 


Fija el locale del componente. 


Mueve este componente a una | 


nueva localización. 


Mueve este componente a una 
nueva localización. 


Fijaelnombre del componentea 
la cadena indicada. 


Redirnensiona este componente 
paraquetengala anchurad. width 
y la altura d.height. 


Redirnensionaeste componente 
para que tenga la anchura y la 
altura indicadas. 


Muestra o esconde este compo- 
nente tal y como se especifica 
con el valor del parámetro b. 


Obsoleto. Reemplazadoporset- 
Visible(boo1ean). 


Obsoleto. Reemplazadoporset- 
Vicible(boo1ean). 


Obsoleto. Reemplazado porget- 
Size(). 


Método Acción 


Obtiene una representación en 
cadena del componente. 


String to String( 


void transferFocus() Transfiere el foco al siguiente 


componente. 


void update(Graphics g) Actualiza el componente. 


| void validate() Aseguraque el componentetiene 


un esquema válido. 


Otra clase importante de AWT es la clase Container. Esta clase se deriva 
de la clase AWT Component y es la base de los contenedores AWT, que 
puede gestionar otros componentes. Las applets y las ventanas de aplicación, 
que pueden visualizar componentes AWT, se basan en la clase Container. 
Dado que en la programación con AWT se utiliza con frecuencia la clase 
Container, como se ve en el siguiente apartado, en la tabla 6.2 aparecen 
listados sus métodos. 


Tabla 6.2. Métodos de la clase Container. 


Método Descripción 


Component add(Component comp) 


Component add(Component comp, 
intindex) 


void add(Component comp, Object 
constraints) 


void add(Component comp, Object 
constraints, intindice) 


Component add(String name, Com- 
ponentcomp) 


void addContainerListener (Contaíner 
Listener 1) 


protected void addImpl(Component 
comp, Object constraints, intindice) 


void addNotify() 


Añade el componente indicado al 
contenedor. 


Añade el componente indicado al 
contenedoren unaposiciónconcreta. 


Añade el componente indicado al 
contenedor. 


Añade, en el índice, el componente 
indicado a este contenedor con las 
restricciones indicadas. 


Añade un componente a este conte- 
nedor. 


Añade uncontainer listenerpara ob- 
tener los eventoscontainerdel conte- 
nedor. 


Añade, en el índice dado, el compo- 
nente indicado al contenedor. 


Permite visualizar el contenedor co- 
nectándolo a un recurso de pantalla 
nativo. 
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Método Descripción 


int countComponentes() (int x, int y)  Obsoleto. Reemplazado porgetcom- 


void deliverEvent(Event e) 
void doLayout() 


Component findComponentAt 


ponentCount(). 


Obsoleto. Reemplazado por dis- 
patchEvent(A WTEvente). 


Hace que el contenedor coloque sus 
componentes. 


Localiza el componente hijo visible 
que contiene la posición indicada. 


Component findComponentAt(Pointp) Localiza el componente hijo visible 


float getAlignmentX0 
float getAlignmentY () 
Component getComponent(intn) 


Component getComponentAt(intx, 
int y) 


que contiene el punto indicado. 


Obtiene la alineación a lo largo del 
eje x. 

Obtiene la alineación a lo largo del 
eje y. 

Obtiene el componente enésimo del 
contenedor. 


Localiza elcomponenteque contiene 
la posición x, y. 


ComponentgetComponentAt(Pointp) Obtiene elcomponente que contiene 


intgetcomponentCount() 
Component[]getComponents() 


Insets getInsets() 


LayoutManagergetLayout() 
Dimension getMaximumSize() 
Dimension getMinimumSize() 


Dimension getPreferredSize() 


el punto indicado. 


Obtiene el número de componentes 
en este panel. 


Obtiene todos los componentes del 
contenedor. 


Determina las intercalaciones del 
contenedor, que indican el tamaño 
del borde del mismo. 


Obtiene el gestor de esquemas del 
contenedor. 


Obtiene el tamaño máximo del con- 
tenedor. 


Obtiene el tamaño mínimo del con- 
tenedor. 


Obtiene eltamaño preferido del con- 
tenedor. 


Método 


Descripcion 


Insets insets() 


void inva/idate() 
boolean ¡sAncestorOf(Componentc) 


void /ayout() 
void list(PrintStream out, int indent) 


void list(PrintWriter out, int indent) 


Component locale(int x, int y) 
Dimension minimumSize() 


void paint(Graphics g) 
voidpaintComponents(Graphics g) 


protected String paramString() 
Dimension preferredSize() 


void print(Graphics g) 
void printComponents (Graphics g) 


protected voidprocessContainer 
Event(ContainerEvent e) 


protected void processEvent 
(ATEvente) 


void remove(Componentcomp) 


void remove(intindice) 


Obsoleto. Reemplazado por getln- 
sets(). 


Invalida el contenedor 


Chequeasielcomponenteestácon- 

tenido en la jerarquía del contenedor. 

Obsoleto. Reemplazado por doLa- 

youto. 

Imprime un listado de este conte- 

nedor a la salida indicada. | 


Visualiza una lista, empezandoen la 
indentación indicada, en la salida 
indicada. 


Obsoleto. Reemplazado porgetcom- 
ponentAt(int, int). 


Obsoleto. Reemplazado porgetMini- 
mumSize(). 


Pinta el contenedor. 


Pinta cada componente del conte- 
nedor. 


Obtiene la cadena que representa el 
estado del contenedor. 


Obsoleto. Reemplazado porgetpre- 
ferredSize0. 


Visualiza el contenedor. 


Visualiza cada uno de los compo- 
nentes del contenedor. 


Procesa los eventos del contenedor 
que ocurren en este, enviándolos a 
Containerlistener. 


Procesaeventosde estecontenedor. 


Retira del contenedor el componente 
indicado. 


Retira el componente del contenedor 
que está en el índice marcado. 


Metodo 


Descripción 


void removeAll() Retira todos los componentes de e 
te contenedor. 


void removeContainerListener Retira el container listenerindicado 
(ContainerListener 1) para que no reciba más eventos 
container de este contenedor. 


void removeNotify() Hace que el contenedorno seavisible 
retirandosu conexión a sus recursos 
de pantalla nativos. 


void setCursor(Cursor cursor) Fija la imagen del cursor al cursor 
indicado. 


void setFont(Font f) Fija la fuente del contenedor. 
void setLayout(LayoutManager mgr) Fija el gestor de esquemaspara este 


contenedor. 

void update(Graphics g) Actualiza el contenedor. 

void validate() Valida este contenedor y todos sus 
subcomponentes. 

protected void validateTree() Deformarecursiva, desciende por el 


árbol del contenedor y recalcula el 
esquema para todos los subárboles 
marcados según los necesite (aque- 
llos marcados como inválidos). 


Crear Applets 


"¡Por fin!", dice el programador novato. "Ya estoy preparado para crea?"] 
una applet". "Cierto", le dice. "Ahora, ¡cuál le gustaría?" "Hmm", dice PN. 

Usted basa sus applets en la clasejava.applet.Applet, que es en sí misma, 
una subclase de la clasejava.awt.Container: 


java.lang.Object 
Ijava.awt.Component 
ljava.awt.Container 
| java.awt.Panel 
Ijava.applet.--—-let 


. a z 7 
Parautilizarlos como referencia, encontrará los métodos de la claseApplet 
en la tabla 6.3. 


Tabla 6.3. Métodos de la clase Applet. 


Método Descripción 


void destroyo Se le llama cuando nos queremos 
deshacer de la applet. 


AppletContext getAppletContext() Determina el contexto de estaapplet. 
El contexto permite a la applet soli- 
citar el entorno en el que se ejecuta. 


String getAppletinto() Obtiene información de esta applet 


AudioClip getAudioClip(URL url) Obtiene el objeto AudioClipespecifi- 
cado por el argumento URL. 


AudioClip getAudioClip(URL url, Obtiene el objeto AudioClip especifi- 

Stringnombre) cado por los argumentos URL y nom- 
bre. 

URL getCodeBase() Obtiene la base URL. 

URL getDocumentBase() Obtiene el documento URL. 

Image getimage(URL url) Obtiene una imagen que puede ser 


pintada en la pantalla. 


Image getlimage(URL url, String name) Obtiene una imagen que puede ser 
pintada en la pantalla. 


LocalegetLocale() Obtiene el locale para la applet. 


String getParameter(String name) Obtiene el valor del parámetro lla- 
mado en la etiqueta HTML. 


String[][]getParameterlntfo() Obtiene información de los paráme- 
tros de la applet. 


void init() Llamado por el browser o el visuali- 
zador de applets para permitir la ini- 
cialización de la applet 


boolean ¡sActive() Determina si esta appletestá activa. 

static AudioClip newAudioClip Obtiene unaudioclipde la URLdada. 

(URL url) 

void play(URL url) Reproduce el audio clip en la URL 
absoluta especificada. 

void play(URL url, String name) Reproduce el audio clipdada la URL 
y un especificador relativo a él. 

void resize(Dimension d) Solicita que esta applet sea redi- 
mensionada. 


Método Descripción 


void resize(intanchura, intaltura) Solicita que esta applet sea redi- 


| mensionada. 
void setSub(AppletStub stub) Establece el stub de esta applet. 
void showStatus(String msg) Solicitaque lacadena sea visualizada 


en la ventana de estado de la applet 


void start() Llamado porel browsero visualizador 
de applet para decir a la applet que 
debería empezar la ejecución. 


void stop() Llamado porel browsero visualizador 
de applet para decir a la applet que 
debería parar la ejecución. 


Veamos un ejemplo. Aquí, se creará la applet, que se vio al principio del 
capítulo, que visualiza el texto "¡Hola desde Java!" en el fichero applet.java. 
Se empieza derivando una nueva clase, applet, de la clasejava. applet .Applet, 
como sigue: 


import java.applet.Applet; 


public class applet extends Applet 
I 


Para visualizar el mensaje en la applet, se usará el método paint, que 13 
applet hereda de la clase Component. Cuando se visualiza una applet, se 
llama a su método paint, y en ese método, se puede situar el código para 
dibujar la applet. Al método paint se le pasa un objeto de la clase Graphim 
que se verá en los próximos capítulos. Esta es la base del trabajo gráfico en 
las applets. Este objeto soporta un método llamado drawString, que se usará 
para dibujar una cadena de texto en la applet. La clase Graphics es una "Y'2% , - 
AWT, por lo que se importarán las clases AWT cuando se sobrescriba el 
método Applet paint por defecto: 


import java.applet.Applet; 
iqort java.awt.*; 


public class applet extends Applet 


{ 
public void paint (Graphics g) 
{ 


Ahora se personaliza el método sobrescritopaint para que escriba el texto 
"¡Hola desde Java!" en la posición (60, 100) en laapplet. Las coordenadas de 
la appletestán en pixels; por lo tanto, (60, 100) está a 60 pixels de la esquina 
izquierda de la applet y 100 pixels más abajo del final de la barra de título. 
Este es el código: 


import Java.applet.Applet; 
import java.awt.*; 


public class applet extends Applet 


{ 
public void paint (Graphic8 g) 


{ 
g.drawString('"lHola desde Javalm, 60, 100); 


1 
1 


Este nuevo método paint dibuja directamente en el área de trabajo de la 
applet. Observe que, también, se puede situar controles, como botones y 
campos de texto, directamente en esta área de trabajo. También se verá cómo 
se hace esto en este capítulo. Con javac, se puede compilar applet.java para 
obtenerjava.class, y asíse acaba de crear una applet. Ya es el momento de 
ver cómo funciona. 


Usar la etiqueta HTML <APPLET> 


"De acuerdo", dice el programador novato, "he creado una applet y la he 
compilado obteniendo el fichero de extensión ".class". ¿Cómo lo veo real- 
mente?" "Hay que usar la etiqueta HTML <APPLET>", le responde. 

Una vez que se ha creado un fichero con extensión ".class", se puede 
cargar a un ISP (o verlo en la propia máquina) y fijarle su protección (ver la 
introducción de este capítulo) para que se pueda leer. A continuación, se 
puede crear una página Web usando la etiqueta <APPLET> para visualizar la 
applet. Asíes el formato de la etiqueta <APPLET>: 


<APPLET 
[CODEBASE = URL] 
CODE = nombre de fichero 
[ALT = Texto alternativo] 
[NAME = nombre de instancia] 


> 


WIDTH = pixels 
HEIGHT = pixels 
[ALIGN = alineación] 
[VSPACE = pixels] 
[HSPACE = pixels] 


[<PARAM NAME = nombre VALUE = valor>] 


[<PARAM = NAME nombre VALUE = valor>] 


< 


/APPLET> 


Estos son los atributos de la etiqueta <APPLET>: 


Esta es una página Web, applet.htrn1, que visualiza la applet creada en el 


CODEBASE: URL que especifica el directorio en el que se busca el 
código de la applet. 


CODE: Nombre del fichero de laapplet, incluyendo la extensión ".class 3 


ALT: Texto que se va a visualizar si un browser soportaapplets pero no 
puede ejecutarse por alguna razón. 


NAME: Nombre de la applet en el browser Web. Deben darse nombres” 
a las applets si se quiere tener la posibilidad de buscar otras applets e 
interactuar con ellas. 


WIDTH: La anchura del espacio reservado para la applet. 


HEIGTH: La altura del espacio reservado para la applet. 


ALIGN: Especifica la alineación de la applet: LEFT (izquierda), RIGHÍ 
(derecha), TOP (arriba), BOTTOM (abajo), MIDDLE (medio), 
BASELINE, TEXTOP, ABSMZDDLE o ABSBOTTOM. 


VSPACE: Espacio ubicado sobre y desde la applet. 
HSPACE: Espacio ubicado a la derecha y a la izquierda de la applet. 


PARAM NAME: Nombre del parámetro que se pasa a la applet. 


PARAM VALUE: Valor de un parámetro. 
7 


apartado anterior (observe que sólo son obligatorios los atributos CODE, 
WIDTH, y HEIGHT): 
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En este caso, nose está especificando un código base, por lo tanto se sitúa 
applet.class en el mismo directorio que applet.html. 

Esta página Web, abierta con Netscape Navigator, aparece en la figura 
6.1. 


F APPLET hoircapo EE 
Fin pi Yew ġo [omneis [ie 
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Asks Horne Search Net:cape Pmt Secunty Chnp 
| O 


y irc di | i Y rimel 3 Lot J Mela G Pap 


hola desde Javal 


Figura 6.1. Una applet funcionando con Netscape Navigator. 


También se puede utilizar el visualizador deapplets de Sun, que viene con 
Java, para ver la applet. Abra la página Web como sigue: 


-appleotviowar applat 


El resultado aparece en la figura 6.2. El visualizador de applets siempre 
soporta la última versión de Java, por si el browser Web no lo hace, y no 
quiere instalar el Java plug-in. Siempre se puede usar el visualizador de 
applets para probar sus applets. 
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Fl 


hola desde Javal 


ple! eiad 


Figura 6.2. Una applet funcionando con el visualizador de applets. 


Gestionar browsers no Java 


"Uh-oh", dice el programador novato, "hay un problema. Algunos us - a - - 
rios están usando un browser ligeramente no estándar llamado 
SuperWildcatl4b...” "Eso suena ligeramente no estándar", le dice. "Y", con- 
tinúa el programador novato, "no soporta Java. ¿Hay alguna forma de infor- 
mar a los usuarios de que están perdiendo algo?" "Claro, "le dice. "Coja una 
silla y lo veremos". 

Si se encierra este texto en el interior de una etiqueta <APPLET>, ese? 
texto será visualizado si el browser Web no soporta Java. Por ejemplo, así es 
como se avisaría a los usuarios de las cosas que se están perdiendo de su 


applet: 
<APPLET code = "applet.class" width = 100 height = 100> 7 
Lo siento, notieneJavaypor lo tanto, no puedevermimaravillosaapplet- 
c/APPLET> 


Introducir etiquetas <APPLET> en el código 


El programador novato suspira. "He estado escribiendo applets, y esu n 
poco complicado”. "¿Qué quiere decir?" le pregunta. "Escribir una página 
Web con una etiqueta cCAPPLET> para probar la salida de la misma, ¿no "Y 
algo más fácil?" "Claro", le dice, "se puede introducir la etiqueta <APPLIET> 
directamente en el código fuente". 

Los desarrolladores de Sun se dieron cuenta de que algunas veces esg 
molesto tener que crear una página Web para probar una applet, por lo que si 


se usa el visualizador de applets, se puede situar una etiqueta <APPLET> 
directamente en el fichero de la applet con extensión "java" en un comenta- 
rio, como sigue: 


import java.applet.Applet; 
import java.awt.*; 
import java.awt.event.*; 
pee 
“«AFFLET 
CobEsapplat. clama 
WIDTH "400 
METIGHT=300 > 
a? APPLET? 
zy 


import java.applet.Applet; 
import java.awt.*; 


public class applet extends Applet 


( 
public void paintíGraphics g) 


( 


g.drawString("iHola desde Java! ,60, 100); 


1 
1 


Después de crear el fichero de extensión ".classWse puede iniciar el 
visualizador de applets con el fichero de extensión ".java" directamente: 


¿aáppiestuilewer applet. .htmr 


Usar los métodos init, start, stop, destroy, paint 
y update 


El programador novato regresa y dice, "Mi browser se ha vuelto graciosillo, 
¡dibuja mis applets en gris!" "Eso es lo que hacen por defecto muchos 
browsers Web", le dice. "Sin embargo, se puede cambiar añadiendo algún 
tipo de código de inicialización en la applet en el método init". 

Hay un número importante de métodos de applets que se deberían conocer: 


e init: Es el primer método a llamar; sólo se le llama una vez. Aquí se 
inicia la applet. 


e start: Llamado después de init. A este método se le llama, cada vez que 
una applet aparece de nuevo en la pantalla. Esto es, si el usuario se va a 
otra página y luego regresa, se llama otra vez al método start. 


e stop: Llamado cuando el browser se mueve a otra página. Se puede usar 
este método para parar la ejecución adicional de threads que su applet 
puede haber arrancado. 


e destroy: Llamado cuando laapplet va a ser eliminada de la memoria. Se 
puede ejecutar la limpieza en este momento. 


e paint: Llamado cuando se va a volver a dibujar la applet. Este método 
pasa un objeto de la clase Graphics, y se puede usar en los métodos del 
objeto para dibujar en la applet. 


e update: Llamado cuando se va a volver a dibujar una parte de la applet. 
La versión por defecto rellena la applet con el color de fondo antes de 
volver a dibujarla, lo que puede llevar a la fluctuación cuando se ejecuta 
animación, en cuyo caso se sobrescribiría este método. 


T 


Se pueden sobrescribir estos métodos para personalizarlos como se quiera. 
Ya se ha sobrescrito el métodopaint para dibujar una cadena de texto; aquíse 
sobrescribe el método init para cambiar el color de fondo de la applet a 
blanco, usando el método de applet setBackground y pasándole el campo 
white de la clase Color de Java. Estaapplet, además, proporciona un esquele- 
to de una implementación de los otros métodos previamente listados. Este es 
el código: 


import java.applet.Applet; 
import java.awt.*; 


public class applet extends Applet 
{ 
public void init0 
[ 
setBackgroundiColor. white); 
} 


public void start () 


( 
} 


public void paint (Graphics g) 


{ 
g.drawString("iHola desde Java!", 60, 100): 


public void stop() 


( 
1 


public void destroyo 


( 
1 
1 


El método init es muy útil, y normalmente se sobrescribe porque permite 
inicializar su applet. En este caso, se ha cambiado el color de fondo de gris 
(el color por defecto en muchos de los browsers) a blanco. En gráficos, hay 


que destacar a las applets. La siguiente sección proporciona una visión gene- 
ral de la gestión de gráficos en las applets. 


Dibujar gráficos en applets 


Aprenderá mucho más sobre el dibujo en applets en unos pocos capítulos, 
pero veremos antes algunos de los métodos de gráficos que usaremos aquí: 


paint: Llamado cuando se va a volver a dibujar la applet. 


e repaint: Se llama a este método para forzar que la applet sea pintada. 


drawString: Dibuja una cadena de texto. 


e setBackground: Fija el color de fondo. 


setForeground: Fija el color de primer plano. 


e draw3Drect: Dibuja un rectángulo 3D. 


drawBytes: Dibuja texto, dado un array de bytes. 


e drawlmage: Dibuja una imagen. 


drawoval: Dibuja un óvalo (incluyendo círculos). 


drawPolyLine: Dibuja una línea con múltiples segmentos. 
e drawRoundRect: Dibuja un rectángulo redondeado. 


e drawArc: Dibuja un arco. 


drawlhars: Dibuja texto, dado un array de caracteres. 


drawline: Dibuja una recta. 


e drawPolygon: Dibuja un polígono. 


e drawRect: Dibuja un rectángulo. 


Dos métodos que particularmente hay que destacar son el método paint, 
con el que se pinta laapplet, y el método repaint, que fuerza a que se llame al 
método paint. 


Usar el plug-in de Java del browser 


"Hey", dice el programador novato, "tengo un problema. Estoy usando los 
dos grandes browsers de Java, pero no soportan las últimas características de 
Java. ¿Qué puedo hacer?" "Hay una solución fácil", le contesta. "Use elplug- 
in Java". s 

Elplug-in Java le permite ejecutar las applets de la última versión de Java 
en Netscape Navigator y Microsot Internet Explorer implementando el en- 
tomo de ejecución de Java como un plug-in para Netscape y un control 
ActiveX para Internet Explorer. Se puede obtener elplug-in de Java en http:/ 
/java.sun.com/products/plugin.Se instala automáticamente al instalar JDK. 

Para usar las páginas Web con elplug-in, se necesita convertir primero su 
HTML, usando el convertidor HTML de Sun, que se puede obtener en http:/ 
/java.sun.com/products/plugin El convertidor de HTML es un fichero Java 
de extensión ".class" que se ejecuta en las páginas HTML para convertir la 
etiqueta <APPLET> de forma que pueda usarse por el plug-in. Se puede ver 
el convertidor de HTML en la figura 6.3. 
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Figura 6.3. El convertidor HTML de Sun. 


Para convertir una página Web y usar el plug-in, se selecciona un fichero 
HTML o ficheros en el convertidor HTML y se hace clic sobre el botón 
Convert. El convertidor cambiará una etiqueta <APPLET> como 


APPLET codesadder. class width=100 height:200>>'ARPLEP> 
en algo como esto: 


<!- "CONVERTED—APPLET" -> 

<!- CONVERTER VERSION 1.0 -> 

COBJECT classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93" 

wIDTH = 200 HEIGHT = 200 codebase="http://java.sun.com/products/ 
plugin/1.2/jinstall-12- 

win32.-»abiffVersion=1,2,0,0"> 

<PARAM NAME = CODE VALUE = adder.class > 


<PARAM NAME="typen VALUE="application/x-java-applet;version=1.2"> 
<COMMENT> 

¡EMBED type="application/x-java-applet;version=1.2"java-CODE = 
adder.class WIDTH = 200 HEIGHT = 200 
pluginspage="http://java.sun.com/products/plugin/1.2/plugin- 
install.html"><NOEMBED>-”/COMMENT> 


<= 
<APPLET CODE = adder.class WIDTH = 200 HEIGHT = 200 > 


El nuevo fichero HTML usará el plug-in Java en lugar de la máquina 
virtual de Java del browser por defecto. Por ejemplo, la figura 6.4 muestra la 
applet de demostración de Swing TicTacToe en http://192. 9.48. 9/products/ 
plugin/1.2.2/demos/applets-icTa“-Toe/e-ample.htnliternet Explorer. 


Leer parámetros en applets 


El gran jefe (GF) aparece mascando un cigarro y dice, "Necesitamos 
personalizar el saludo de nuestra applet para cada cliente". "Pero hay miles 
de clientes", le dice. "No podemos recompilar la applet para cada uno y 
almacenar cada versión nueva en el sitio Web". "¿Qué sugiere?", pregunta GF. 

¿Qué le dirá? 

Se puede pasar parámetros a las applets en la etiqueta <APPLET>, y el 
código applet puede leer los valores de esos parámetros, lo que significa que 


para personalizar la applet, sólo necesita dar los diferentes parámetros en la 
etiqueta <APPLET>. Realmente, para conseguir el valor de un parámetro, se 
usa el método getparameter de la clase Applet, pasándole el nombre del 
parámetro como se especifica en la etiqueta <PARAM>. El método 
gerParameter devolverá el valor del parámetro que fue establecido en la 
etiqueta <PARAM>. 


oa dar ell ra e Epi [Tabas en coran a e eel 


dr 


Figura 6.4 Utilizando el plug-in de Java. 


Este es un ejemplo en el que se pasa un parámetro llamado cadena a una- 
applet; el valor de este parámetro es el texto que la applet debería visualizar. 
Así es el código: 


import java.applet.Applet; 
import java.awt.*; 


pe 
<APPLET 
CODE=applet.class 
WIDTH=200 
HEIGHT=200 > 
CPARAM NAME = string VALUE = "iHola desde Java!'"'> 
</APPLET> 
a 


public class applet extends Applet 


{ 
public void paint (Graphics g) 


{ 


p: drawStringigatParamatar i" cadana™], $0, 10015 


Usar las consolas de Java en los browsers 


"Todo este material de draw String está bien", dice el programador novato, 
"pero ¿qué hay de la consola de Java? ¿Y si uso Systern.out.println en una 
applet?" "Eso depende”, le dice, "de su browser". 

Esto es unaapplet que visualiza un mensaje y usa System.out.println para 
visualizar en la consola: 


import java.applet.Applet; 
import Java.awt.*; 


public class applet extends Applet 


1 
public void paint (Graphics g) 
I 
g.drawString("iHoladesde Java!", 60, 100); 
Systern.out.-rintln(--Holdesde Java!"); 


) 


Si se ejecuta esta applet con el visualizador de applets Sun, la applet se 
abrirá en una ventana separada, y se verá "¡Hola desde Java!" en la ventana de 
la consola. 

Los browsers Web, con frecuencia, tienen también una consola Java, 
aunque normalmente hay que habilitarlas antes de usarlas. La manera de 
habilitar la consola Java difiere, desafortunadamente, de un browser a otro y 
de una versión a otra. Actualmente, en Internet Explorer se habilita ejecutan- 
do el comando Internet del menú Ver, hacer clic sobre la lengüeta Avanzadas, 
y seleccionar la casilla de activación Java Console Enabled (Consola de Java 
habilitada). La figura 6.5 muestra el resultado de laapplet anterior tal y como 
aparece en la consola de Java de Znterner Explorer, que emerge cuando se 
visualiza. 

En Netscape Navigator, se puede abrir la consola de Java ejecutando el 
comando Java Console (Consola de Java) del menú Communicator. 


Añadir controles a las applets: Campos de texto 


"De acuerdo", dice el programador novato, "ahora se puede dibujar texto 
en una applet. Pero, ¿y si quiero que el usuario pueda meter algo de texto?" 
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"Para eso, " le dice, "se puede usar cualquier clase de controles de texto, 
como los cuadros de texto". 


Figura 6.5. Usar la consola de Java de Internet Explorer. 


Los cuadros de texto están entre los controles más básicos que se pueden 
usar en AWT. Un cuadro de texto visualiza una línea sencilla y permite al 
usuario editarlo. Veremos los cuadros de texto, formalmente, en el siguiente 
capítulo, pero también podremos usarlos aquí al hablar de la gestión de 
eventos. Esto es un ejemplo de cuadro de texto en el que se crea uno de 20 
caracteres en un método init de laapplet (observe que se están importando las 
clases AWT para poder usar los cuadros de texto): 


import java.applet .Applet; 
import java.awt.*; 


public clase applet extends Applet 


( 
public TextField textl; 


public void inito 
I 
textl = new TextField(20);5 


Después de crear un nuevo control, se le debe añadir a la applet para que 
se visualice. He aquí un ejemplo: 


public void init Í) 


textl = new TextField(20); 
add (text1); 


El método add añade el control al gestor de esquemas actual, que decide 
donde se debería situar el control (se verán los detalles sobre los gestores de 
esquemas en el siguiente capítulo). Ahora que el cuadro de texto se ha 
añadido a la applet, se puede situar el texto "¡HOla desde Java!" en el cuadro 
de texto con el método setText, como sigue: 


public void init Í) 
{ 
textl = new TextField(20); 
add (text1); 
te-tl.setText (~~Holkæsde Java!"); 
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Figura 6.6. Añadir un campo de texto a una applet. 


El resultado de este código aparece en la figura 6.6, donde se puede ver el 
cuadro de texto con el mensaje que se ha puesto en él. El usuario además 
puede editar este texto. Echaremos un vistazo más profundo a los cuadros de 
texto en el siguiente capítulo. 

Otro control básico es el control de AWT Button. Usaremos los botones y 
los cuadros de texto para discutir la gestión de eventos, por lo tanto, introdu- 


ciremos el control Button en el siguiente apartado. En el siguiente capítulo, 
aprenderemos más detalles sobre los botones y los cuadros de texto. 


Añadir controles a las applets:botones 


"Estoy preparado para el siguiente paso", dice el programador novato. "He 
añadido cuadros de texto a mis applets. ¿Qué es lo siguiente?" "Botones", le 
responde. "Tome una silla y hablaremos de ellos”. 

Los usuarios pueden hacer clic sobre los botones de su appler para indicar 
que quieren ejecutar alguna acción; por ejemplo, se puede tener un botón 
llamado "Cambiar color" que, cuando se haga clic sobre él, cambie el color 
de fondo de la applet usando el método setBackground. Los botones son 
soportados por la clase java.awt.Button, que discutiremos en detalle en el 
siguiente capítulo. Es bastante fácil añadir un botón a una applet, se hace de 
la misma forma que se añade un cuadro de texto, como se demostró en el 
ejemplo anterior. Aquí se está creando y añadiendo un botón con el texto 
"¡Haga clic aquí!": 


public class applet extends Applet 


TextField textl; 
Button buttonl; 


public void init (1 


( 
textl = new TextField(20); 


add (text1); 
butonl = new Butt-n(“iHagalic aquí!"); 
add (buttonl) ; 


El truco, realmente, está en que ocurra algo cuando el usuario haga clic * 
sobre el botón, y para eso, tendremos que echar un vistazo a la gestión de 
eventos (ver el siguiente punto). 


Gestión de eventos 


"Hey", dice el programador novato, "he puesto un botón en mi applet, 
pero cuando hago clic sobre él, no ocurre nada. ¿Qué pasa?" "Lo que pasa, " 
le dice, "es que tiene que implementar la gestión de eventos". 


La gestión de eventos, proceso de respuesta que se genera al hacer clic 
sobre el botón, los movimientos del ratón, etc, ha llegado a ser un tema 
complejo en Java. Desde Java 1.1, la gestión de eventos ha cambiado 
significativamente. El modelo actual se llama gestión de eventos delegado. 
En este modelo, se debe registrar específicamente en Java si se quiere gestio- 
nar un evento, como puede ser hacer clic sobre un botón. La idea es que se 
mejora la ejecución si sólo se informa de los eventos al código que necesita 
gestionarlos y no al resto. 

Los eventos se registran implementando una interfaz de listener de even- 
tos. Estos son los eventos de listeners disponibles y los tipos de eventos que 
gestionan: 


ActionListener: Gestiona los eventos de acción, como hacer clic sobre 
los botones. 


AdjustementListener: Gestiona los casos en los que un componente es 
escondido, movido, redimensionado o mostrado. 


ContainerListener: Gestiona el caso en el que un componente coge o 
pierde el foco. 


ItemListener: Gestiona el caso en el que cambia el estado de un elemen- 
to. 


KeyListener: Recibe los eventos de teclado. 


MouseListener: Recibe en los casos en que es pulsado el ratón, mete un 
componente, sale un componente o es presionado. 


MouseMotionListener: Recibe en el caso en que se arrastra o mueve el 
ratón. 


TextListener: Recibe los cambios de valor de texto. 


WindowListener: Gestiona los casos en que una ventana está activada, 
desactivada, con o sin forma de icono, abierta, cerrada o se sale de ella. 


Cada listener es una interfaz, y se deben implementar los métodos de la 
interfaz (para más detalles sobre las interfaces, ver el capítulo anterior). A 
cada uno de estos métodos se le pasa un tipo de objeto que corresponde al 
tipo de evento: 


ActionEvent: Gestiona botones, el hacer doble clic en la lista o hacer 
clic en un elemento del menú. 


AdjustementEvent: Gestiona los movimientos de la barra de desplaza- 
miento. 
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e ComponentE vent: Gestiona el caso en el que un componente es escondi- 
do, movido, redimensionado o llega a ser visible. 


e FocusEvent: Gestiona el caso en el que un componente coge o pierde el 
foco. 


e InputEvent: Gestiona la marca de activación en una casilla de activa- 
ción y el hacer clic en un elemento de la lista, hacer selecciones en los 
controles de opción y las selecciones de los elementos de un menú. 


e KeyEvent: Gestiona la entrada desde el teclado. 


e MouseEvent: Gestiona los casos en que se arrastra el ratón, se mueve, se 
pulsa, se presiona, se suelta o entra o sale un componente. 


e TextEvent: Gestiona el valor de un cuadro de texto o si ha cambiado. 


e WindowEvent: Gestiona el caso en el que una ventana está activada, 
desactivada, en forma de icono, sin forma de icono, abierta, cerrada o 
abandonada. 


Gestión de eventos estándar 


Ya es hora de poner a funcionar algo de lo que hemos visto hasta ahora. 
Empezaremos añadiendo un nuevo botón con el texto "¡Haga clic aquí!" en 
una applet, así como añadir un listener de acciones que será notificado 
cuando se haga clic sobre el botón. Para añadir un listener de acciones al 
botón, se usa el método addActionListener del mismo, pasándole un objeto 
que imprementa los métodos de la interfazActionListener. Este objeto puede 
ser un objeto de la clase principal de la applet o de otra clase. Trataremos 
ambas variaciones aquí, empezando con el envío de las notificaciones de 
eventos a la clase main de la applet. 


Aquí vemos cómo se añade un listener de acciones a un botón, enviando 
notificaciones de eventos al objeto de la applet actual (observe que indicamos 
que la clase applet ahora implementa la interfaz ActionListener): 


CAPPLET 
Ape 
WIOTH=200 


AEIGHE=300 


public class applet extends Applet implements Actionlistener 


{ 
TextField textl; 


Button buttonl; 


public void hito0 


textl = new TextField(20); 
add (text1) ; 
buttonl = new Button (" ¡Haga clic aquí! ") 
add (button1) ; 
buttonl.addActionListener (thia); 


1 


Ahora hay que implementar los métodos de la interfaz ActionListener. 
Esta interfaz sólo tiene un método, actionPerformed, al que se le pasa un 
objeto de la clase ActionEvent cuando se hace clic sobre el botón: 


void actionPerformed (ActionEvent e) 


Los objetos ActionEvents (que veremos en el siguiente capítulo) heredan 
un método llamadogetSourcede la clase EventObject, y este método devuel- 
ve el objeto que produjo el evento. Eso quiere decir que se puede comprobar 
si este evento fue producido por el botón, buttonl, y en ese caso, situar el 
texto "¡Hola desde Java!" en el cuadro de texto textl de esta forma: 


import Java.applet.Applet; 
import java.awt.*; 
import jJava.awt.event.*; 


public class applet extends Applet implements ActionListener 
( 

TextField textl; 

Button buttonl; 


public void inito0 
{ 
textl = new TextField(20); 
add (text1); 
buttonl = new Button ("iHaga clic aqui!"); 


public void actionPerformed (ActionEvent event) 


1 
String msg = new String (niHoladesde Java!"); 


if (event .getsource() == buttonl) ( 
textl.setText (msg) ; 
1 


) 


Estaapplet aparece en la figura 6.7. Cuando se hace clic sobre el botón, el 
texto "¡Hola desde Java!” aparece en el cuadro de texto. 

La clase que se registra para recibir los eventos no necesita ser la clase 
principal de la applet (y de hecho, los desarrolladores de Sun originalmente 
intentaron que no lo fuera, aunque ahora es la práctica común). Veremos el 
uso de otras clases para recibir eventos, próximamente. 
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Figura 6.7. Soporte de hacer clic sobre botones. 


Uso de clases delegadas 


Veamos un ejemplo en el que se está creando una nueva clase para 
implementar la interfazActionListener. 

Observe que esto es un poco pesado, porque se quiere trabajar con el 
cuadro de texto y los controles de botón en el objeto principal de la applet, 
por lo que hay que pasar y almacenar referencias a ese objeto en el nuevo 
constructor de la clase: 


import Java.applet .Applet; 
import Java.awt.*; 
import jJava.awt.event.*; 


$ 


public class applet extends Applet 


1 
public TextField textl; 


public Button buttonl; 


public void initoO 
i 
textl = new TextField (20); 
add (text1); 
buttonl = new Button (";Hagaclic aq~i!"); 
add (button1); 
a obj = new a(this); 
buttonl addAotionLisrtenar iab] i; 


class a iqlements ActionListener { 
applet « 


a(applet appletobject) 


{ 
c = appletobject; 
1 


public void actionPerformed (ActionEvent event) 
{ 
String msg = new String ("iH0la desde Java!"); 
if (event .getSource0 == c.buttonl){ 
c.textl.setText (msg) ; 
1 


Este código funciona igual que la versión anterior de esta applet, salvo 
que internamente usa una nueva clase para gestionar eventos, no la clase 
principal de la applet. Hay veces que esto es útil, como cuando se tienen 
muchos eventos para gestionar y nose quiere agrandar la clase principal de la 
applet. 

Además, hay otras formas de determinar el objeto que causó el evento, por 
ejemplo, se pueden usar comandos. 


Uso de los comandos de acción 


Java permite asociar comandos con eventos causados por los botones' 
AWT y los elementos del menú. Cuando se trabaja con botones, el comando 
por defecto es la inscripción del botón (veremos cómo se crean los comandos 
personalizados en el siguiente capítulo), así podemos determinar en qué 
botón se ha hecho clic mirando su inscripción (no es una buena idea si su 
programa cambia las inscripciones). Se puede obtener el comando para un 
botón con el método getActionCommand. Aquí vemos cómo se implementa 


la applet anterior usando los comandos: 


import jJava.applet.Applet; 
import Java.awt.*; 
import java.awt.event.*; 


public class applet extends Applet implements ActionListener { 


TextField textl; 
Button buttonl; 


public void hit () 


{ 


textl = new TextField(20); 

add (text1); 

buttonl = new Button (";Hagaclic aquí!"); 
add (button1); 
buttonl.addActionListener (this); 


public void actionPerformed (ActionEvent event) 


( 


Esto le introduce en el proceso de la gestión de eventos de una manera 
moderna. Sin embargo, la antigua forma de Java 1.0 todavía se ejecuta en 
Java, aunque se considera obsoleto. Por motivos deexhaustividad, le echare- 


String mag = new String (mlHoladesde Javal*); 
String caption = event .getActionCommand0; 


if(caption.emala("flaga clic a-11"))i 
Esxtl.snatTart magi; 
) 


mos un vistazo en el siguiente punto. 


La forma antigua de gestionar eventos 


Java 1 O usa un acercamiento no delegado a los eventos. En el modelo de 
eventos de Java 1.0, nose necesita registrar la obtención de eventos, se pasan 
de cualquier forma, y se pueden gestionar en un método llamado action. Por 
ejemplo, aquí tenemos cómo aparecería la applet anterior usando el modelo 
de eventos antiguo: 


import java.applet.Applet; 
import java.awt.*; 


public class First extends Applet 


( 
TextField textl; 


Button buttonl; 


public void hitoO0 

I 
textl = new TextField(20):; 
addítextl); 
buttonl = new Button("Púlseme"); 
add (button1); 


public boolean action (Event e, Object o) 
1 
String caption = (String)-”; 
String msg = "¡Hola desde Java!"; 
if (e.target instanceof Button) ({ 
if (caption == "Púlseme'){ 
textl.setText (msg); 
1 
1 


return true; 
> 


El problema era que el método action con frecuencia llegaba a ser enorme, 
por lo que los diseñadores de Java introdujeron el modelo de eventos delega- 
do en el que se pueden pasar eventos donde se quiera si estar restringidos a un 
método action. 

De hecho, hay otra forma de gestionar eventos, por extensión de los 
componentes. 


Extender componentes 


Si le gusta ser furtivo, se pueden gestionar eventos derivando nuevas 
clases de componentes y sobrescribir los métodos de los componentes que 
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gestionan eventos. De hecho, esta forma de hacer las cosas termina con la 
técnica de gestión de eventos de Java 1.0, porque toda la gestión de eventos 
tiene lugar en un método; sin embargo, esto es descorazonador. A pesar de 
ello, lo veremos aquí para completar el tema. 

Aquí vemos cómo implementamos la applet extendiendo la clase -utton-' 
en una clase derivada llamada newButton. En esta nueva clase, 
sobrescribiremos el método processActionEvent de la clase Button, 
visualizando el texto "¡Hola desde Java!" en el campo de texto de la applet 
después de llamar al método processActionEvent de la clase Button: 


import jJava.applet.Applet; 
import Java.awt.*; 
import jJava.awt.event.*; 


class newButton extends Button 
I 
applet a; 


newButton (applet aref, String S) 
í 
euper (8); 
a = aref; 
enableEvents (AWTEvent . ACTION—-EVENT-MASK) ; 
1 
protected void processActionEvent (ActionEvent e) 
( 
super .processActionEvent (e); 
a.textl.->-etText (““Holalesde Javal"); 


) 


Ahora todo lo que tenemos que hacer es crear un nuevo botón de esta claseó 
y añadirlo a la applet: 


public class applet extends Applet ( 


TextField text1l; 
Button buttonl; 


public void initoO 

( 
textl = new TextField(20); 
add (text1); 


bttonl = new newButton (this, "¡Haga clic aquí]"); 
add (buttonl)'; 


} 


Eso es todo; ahora esta applet funciona como las otras. 


Usar las clases adaptador 


"Ugh", dice el programador novato, "entiendo que el modelo de eventos 
delegado lo utilizan las interfaces listener, pero algunas veces es una pena 
tener que implementar todos los métodos de una interfaz cuando se quiere 
usar uno solo". "Es cierto", le dice, "por eso, Sun introdujo las clases adapta- 
dor, para hacer que todo el proceso sea mucho más fácil". 

Las clases adaptador son clases que ya han sido implementadas en varias 
de las interfaces de eventos disponibles. Cada método de una interfaz está 
implementado como método vacío, sin ningún código, en una clase adapta- 
dor, y todo lo que se necesita hacer es sobrescribir el método o métodos que 
se quiera. 

Veamos un ejemplo. En este caso, empezaremos con unaappletque alma- 
cena una cadena, "¡Hola desde Java!", por defecto, y visualiza esa cadena en 
el método paint. Luego se va a añadir un listener de ratón (aprenderá más 
sobre ello en el siguiente capítulo) a la applet, para que cuando el usuario 
haga clic en la applet, aparezca el mensaje "¡Holaa Java!". Al igual que la 
interfaz ActionListener, la interfaz MouseListener tiene cinco métodos que 
deben implementarse. Sin embargo, se quiere usar el método mouseClicked 
para gestionar el hecho de que se haga clic en el ratón, por lo que usaremos la 
clase MouseAdapter en su lugar. 

Empezaremos añadiendo una clase que implementa un listener de ratón al 
programa. Esta clase crea una subclase de la clase MouseAdapter, y lo llama- 
remos ma: 

import java.applet.Applet; 


import java.awt.*; 
import java.awt.event.*; 


public class applet extends Applet 


public String s = "¡Hola desde Java!"; 


public void init () { 
addMouselListener (new ma (this)); 


1 


public void paintiGraphics g) 
I 
g.drawStringis, 60, 100); 


1 
1 


Se pasa un objeto de la clase principal de la applet al constructor de la 
clase ma por lo que se puede llegar a los campos de laapplet. Cuando se hace 
clic en el ratón, se reemplaza la cadena de texto en la applet con el texto 
"¡Hola a Java!" y luego se repinta la applet, haciendo que la nueva cadena 


aparezca en la pantalla: 


class ma extends MouseAdapter ( 
applet a; 


ma (applet appletobject) 


{ 
a = appletobject; 


1 


public void mouseClicked (MouseRrent me) 


{ 
a.8 = nfH~ la Java!"; 


a.repaintoO; 


1 
7 


El resultado de este código aparece en la figura 6.8, observe que esto era 
un poco complicado porque teníamos que pasar el objeto applet al constructor 
de la clase ma para que la clase pueda alcanzar los campos de la clase applet. 


Mipit Vimer appl.. 
Arid 


Figura 6.8. Hacer clic sobre el botón con las clases adaptador. 


Por otro lado, las clases internas tienen acceso a los campos de sus clases 


encerradas, por lo que los adaptadores están, con frecuencia, implementados 
como clases internas. Veremos esto a continuación. 


Usar clases adaptador internas anónimas 


En el capítulo anterior vimos las clases internas anónimas. Estas clases 
tienen el siguiente formato especial: 


new SuperType(constructor parameters) 


( 
//métodos y datos 


) 


Aquí, SuperType es la clase o interfaz de la clase interna anónima que es 
derivada. En este caso, se va a derivar una clase interna anónima de la clase 
MouseAdapter para implementar la applet que vimos en el apartado anterior. 
Observe que se está sobrescribiendo el método mouseClicked como se hizo 
en el punto anterior, pero ya es hora de usar una clase interna anónima, que 
hace que el código sea mucho más compacto: 


import java.applet.Applet; 
import java.awt.*; 
import java.awt.event.*; 


public class applet extends Applet 


public String s = "iHola desde Java!" ; 


> 


public void hitoO0 ( 
addMouseListener (new MoueeAdapter () ( 
public void ->usePressed (MouseEventme) ( 


e = "yBola a Java!"; 
repaintO; 
11); 


public void paint (Graphics g) 


g.drassiringla a=] 1001 


Crear ventanas de aplicación 


El programador novato aparece y dice, "De acuerdo, ahora se pueden cre y 
applets, pero ¿qué hay de las aplicaciones que usan ventanas?" "Correcto, - Je 
dice. 

Al igual que se escribían applets, cuando se escribe una aplicación det 
ventana, se es responsable de crear su propia ventana en la que se visualiza 
esa aplicación. El tipo de ventana más común para usar esto es la ventana de 
Java Frame, soportada en la clase java.awt.Frame. Este es el diagrama de 
herencia para esa clase (esta clase se deriva de la clasejava.awt. Window, que 
trataremos dentro de unos pocos capítulos): 


AAA ale PA al 
Java, awt Contaloers 


Jara. awt.Aindc 


| — java. awt. Frame 


Encontrará los constructores de la clase Frame en la tabla 6.4 y su? 
métodos en la tabla 6.5. 


He aquí un ejemplo en el que se deriva una clase nueva, AppFrame, de la' 
clase Frame y se personaliza para visualizar la cadena "¡Hola desde Java!", 
para hacer que aparezca la applet desarrollada anteriormente. 


Tabla 6.4. Constructores de la clase Frame. a 


Constructor Descripción 


| Frame Construye una nueva instancia de Frame 
que es inicialmente invisible. 


Frame(String título) Construye un nuevo objeto Frameque es 
invisible, con el título dado. 


Tabla 6.5. Métodos de la clase Frame. 


Método 


void addNotify() 


protected void finalize() 


| int getCursorType() 


statíc Framel]JgetFrames() 


| Image getlconlmage() 


MenuBar getMenuBar() 
int getState() 
Stríng getTitle() 


boolean isResizable() 


protected String paramString() 


void remove(MenuComponentm) 


void removeNotify() 


void setCursor(int cursorType) 


Descripción 


Hace que este marco sea visible conec- 
tándolo a un recurso nativo de pantalla. 


Llamado cuando elframevaa ser eliminado 
por la colección garbage. 


Obsoleto. Reemplazado por Component. 
getCursor(). 


Obtiene un array que contiene todos los 
frames creados por la aplicación. 


Obtiene la imagen que se va a visualizar 
en el icono minimizado. 


Obtiene la barra de menú. 
Obtiene el estado de la ventana. 
Obtiene el título de la ventana. 


Indica si esta ventana es redimensionable 
por el usuario. 


Devuelveel parámetrostringdeestaventana. 


Retira la barra de menú especificada de 
esta ventana. 


Hace que este frame no sea visible, reti- 
rando su conexión de sus recursos de 
pantalla nativos. 


Obsoleto. Reemplazado por Component. 
seiCursor(Cursor). 


void setlconlmage(Image image) Fija la imagen que se va a visualizar en el 


void setiMenuBar(MenuBar mb) 


void setResizable(boo1ean 
resizable) 


void setState(int estado) 


void setTitle(String título) 


icono minimizado de esta ventana. 


Fija la barra de menú de estaventana para 
que sea la barra de menú indicada. 


Establece si esta ventana es redimen- 
sionable por el usuario. 


Fija el estado de esta ventana. 


Fija el título de esta ventana a la cadena 
indicada. 


Como con la clasejava.applet.Applet, la clasejava.awt.Frame es derivay 
da de la clase java.awt.Component, se puede usar el método paint para 
visualizar gráficos en la clase Frame. De hecho, el métodopaint sería como 
lo hemos creado anteriormente en el fichero de la aplicación, app.java. Este 
es el código: 


import java.awt.*; 
import java.awt.event.*; 


class AppFrame extends Frame 
( 
public void paint (Graphics g) 


{ 
g.drawString("lHola desde Javalm, 60, 100); 


1 
> 


Se necesita un método main para arrancar la aplicación, por lo que crea? 
mos ese método en una nueva clase llamada app: 


public class app 
( 


public static void main (String [1 args) 


1 
de 
Para visualizar elframe de una ventana de aplicación, se crea un objeto de 


la clase AppFrame, como sigue: 


public class app 
I 


public static void main(String [] args) 


( 
APpoFra-mf = new AppFrame (); 


x 


Ahora se da al objeto un tamaño de 200 x 200 pixels y se visualiza en la 
pantalla con el método show: 


public class app 


public static void main(String [1 args) 


I 


AppFrame f = new AppFrameO0: 


£.satEeizre(300, 200)p 


abolir 


Hola pende Jana! 


Figura 69. Crear una ventana de aplicación. 


Los resultados de este código aparecen en la figura 6.9. Como se puede 
ver, el mensaje "¡Hola desde Java!" aparece en la aplicación, como se inten- 
taba. Además se pueden añadir controles a esta aplicación, como se hizo con 
la applet del botón antes, en este capítulo. 

Hay algo más que mencionar aquí: primero, si se lanza una aplicación con 
la utilidad java (es decir, como java app), esa herramienta esperará hasta que 
la aplicación devuelva el control a la consola. Desde el punto de vista del 
usuario, la consola parece estar colgada hasta que se abandone la aplicación. 
Si se quiere controlar el retorno inmediatamente a la consola después de que 
la aplicación sea lanzada y visualice su propia ventana, hay que usar la 
utilidad javaw en su lugar. Ver el capítulo 1 para más información. 

Otro punto importante es que si se quieren distribuir las aplicaciones a los 
usuarios que no tienen el JDK instalado, se puede usar el entorno de ejecu- 
ción de Java (JRE). De nuevo, ver el capítulo 1 para más detalles. 

Finalmente, es importante apuntar que no hay forma fácil de salir de la 
aplicación en la figura 6.9; hacer clic sobre el botón Cerrar no tiene efecto. Se 
puede pulsar Ctrl-C para finalizar la ejecución de la herramienta java en la 
ventana de la consola, pero eso es bastante complicado. En su lugar, se tiene 
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que gestionar los eventos de cierre de ventana para terminar la aplicacióJ 
cuando la ventana se cierra. Echemos un vistazo a eso en el siguiente punto. ! 


Salir de una aplicación al cerrar su ventana 


"Hey", dice el programador novato, "fue un poco difícil acabar con MY, 
primera ventana de aplicación, hacer clic sobre el botón Cerrar no tiene 
ningún efecto". "Entonces, ¿cómo se termina la aplicación?", le pregunta. 
"Apagando mi ordenador”, dice el PN suspirando. 

Java espera que se gestione el caso en el que el usuario haga clic en e? 
botón Cerrar en una ventana de aplicación (aunque esto hubiera sido más 
fácil con ventanas Swing). Para finalizar una aplicación cuando el usuario 
haga clic en el botón Cerrar, se deben capturar los eventos ventana, con la 
ayuda de la interfaz WindowListener. Aquí veremos una forma compacta de 
hacerlo, modificando la aplicación desarrollada en el capítulo anterior usan- 
do la clase Window Adapter, que implementa la interfaz WindowListener con 
una implementación vacía de cada método. En este caso, usaremos una clase 
adaptador interna anónima (ver el apartado correspondiente en este capítulo 
para más detalles) y sobrescribir el evento windowClosing. En ese método 
del evento, añadiremos código para salir dela aplicación System.exit(O). Esto 
finaliza la aplicación con un código de salida de O (que significa una termina- 
ción normal). Este es el código: 


import java.awt.*; 
import java.awt.event.*; 


class AppFrame extends Frame 
I 
public void paint (Graphics g) 
{ 
g.drawString(";Holadesde Java!", 60, 100); 
1 


public class app 
{ 


public static void main (String [] args) 
I 
AppFrame f = new AppFrameo0; 


f.adBWindmListener (new windowAdapter0 Cpublic void 
windowClosing (WindOwEvent e) (system.exit (0) ;>)); 


Esto es todo. Ahora cuando se hace clic en el botón Cerrar de la aplica- 
ción, la ventana se cierra y la aplicación finaliza. 


Aplicaciones que se pueden ejecutar como 
applets 


El gran jefe (GF) llega y dice, "tenemos que recortar los costes de desarro- 
llo. De ahora en adelante, todas las applets deben ser también aplicaciones". 
"Hmm", le dice, "¿para cuándo tiene que estar eso?" "¿NO está todavía? 
pregunta GF. 

Si se añade un método main a unapplet, esaappletse puede ejecutar como 
applet y aplicación; Java ignorará el método main cuando se ejecuta como 
una applet, y se ejecutará el método main cuando se ejecuta como una aplica- 
ción. 

Este es un ejemplo en el que se han combinado la applet y la aplicación 
desarrollada en este capítulo en un programa: 


import java.applet.Applet; 
import java.awt.*; 
import java.awt.event.*; 


import java.applet.Applet; 
import java.awt.*; 


public class applet extends Applet 
I 


public static void main(String [] args) 


{ 
AppFrame f = new AppFrameO0; 


f.addWindowListener (new WindowAdapterO (public void 
windowClosing(Window-vente) (System.exit (0);))); 


17 


public void paint (Graphics g) 


( 
g.drawString(''iHola desde Java!", 60, 100); 


class AppFrame extends Frame 
( 
public void paint (Graphics g) 
( 
g.drawString("iHola desde Java! ",60, 100); 
1 


Este código se puede ejecutar como applet y también como aplicación e2? 
gran jefe estará orgulloso). 


IM awT: Cuadros 


de texto, botones, 
casillas de 
activación y 
plantillas 


Este capítulo trata un número importante de componentes AWT: cuadros 
de texto, botones, casillas de activación y botones de opción. Ahora que ya 
estamos habituados a los componentes visibles, echaremos un vistazo a los 
gestores de esquemas o plantillas de Java que permiten ordenar los compo- 
nentes en una applet o aplicación. Además revisaremos los paneles en Java, 
que permiten unir componentes en una superficie y mandarla al gestor de 
esquemas. Empezaremos echando un vistazo a los cuadros de texto. 


Cuadros de texto 


Los cuadros de texto son los componentes básicos de AWT para soportar 
texto. Estos componentes gestionan cadenas de texto de una dimensión; 
permiten visualizar el texto que el usuario escribe, poner máscaras de texto 
cuando se introduce una clave secreta, leer el texto que el usuario ha incluido 
y mucho más. Dentro de AWT, estos componentes son los fundamentales, 
junto con los botones. 


Botones 


Los botones proporcionan al usuario una forma rápida de iniciar alguna” 
acción. Hay que hacer clic sobre todos ellos. Cualquier usuario está familia- 
rizado con los botones y ya vimos cómo funcionan al discutir la gestión de 
eventos en el capítulo anterior. A los botones se les puede dar una inscrip- 
ción, como "¡Púlseme!". Cuando el usuario hace clic sobre el botón, el 
código recibe una notificación, siempre que se haya registrado la gestión de 
eventos desde el botón. 


Casillas de activación 


Las casillas de activación son como los botones, salvo que tienen un doblé' 
estado, es decir, pueden estar seleccionadas o no. Cuando se seleccionan, 
aparecen con algún tipo de marca, como puede ser una marca de activación o 
una X (el tipo de indicación visual depende del sistema operativo en que se 
haya programado AWT, que es una de las razones por las que Sun introdujo 
Swing, que puede visualizar componentes con la misma forma independien- 
temente del sistema operativo). El usuario puede marcar una casilla de-mai- 
vación para seleccionar un tipo de opción, como los ingredientes ce un 
sandwich, habilitar la revisión de ortografía automáticamente o habilitar la 
impresión mientras se está haciendo otra cosa. Se usan las casillas de aztiya- 
ción para permitir al usuario opciones de selección no exclusivas; por t:jem- 
plo, la revisión automática de ortografía y la impresión en backgroundpiieden 
estar habilitados al mismo tiempo. Los botones de opción, sin embarg-¿9n 
otra historia. 


Botones de opción 


Utilizando los botones de opción, se puede permitir al usuario seleccr tie 
una entre un conjundo de opciones mutuamente excluyentes. Sólo ulitil de 
esas opciones puede seleccionarse al mismo tiempo. Por ejemplo, u::4nd0 
botones de opción, se puede dejar al usuario seleccionar un color de irnpre- 
sión y el día de la semana. En AWT, los botones de opción son un tipo de 
casilla de activación, y cuando se seleccionan, visualizan un punto red™mdo, 
un cuadrado o algún otro tipo de indicación (de nuevo, la indicación visual 
depende del sistema operativo). Veremos cómo funcionan en este capítulo. 


plantillas 


Hemos añadido componentes a las applets y aplicaciones usando el méto- 
do add. Este método es, realmente, un método del gestor de esquemas que 
hay por defecto, elfZow layout manager. Por defecto, este gestor es el respon- 
sable de ordenar los componentes en las applets AWT. Elflow layout mana- 
ger ordena los componentes de la misma forma que un procesador de texto 
debería ordenar las palabras a lo largo de la página y pasar a la siguiente línea 
cuando sea necesario, creando lo que Sun llama un flujo de componentes. 
Veremos que se pueden personalizar los esquemas de flujo de forma extensi- 
va. Sin embargo, las limitaciones son claras, especialmente si se trata de 
mantener alguna posición de componentes respecto a otros, porque si el 
usuario cambia el tamaño de la applet o aplicación, todos los componentes 
tendrán que moverse. Por otro lado, hay otros gestores de esquemas en AWT 
(y algunos nuevos en Swing), y veremos el grid AWT, border, card y grid 
layout en este capítulo. 

¿Por qué no se puede poner un componente donde se quiera y luego 
olvidarse de él? Los programadores novatos de Java con frecuencia se frus- 
tran al tratar con los gestores de esquemas de AWT, y quieren saber por qué 
no pueden dar las coordenadas de los componentes que quieren utilizar. De 
hecho, se puede, aunque cada uno sería responsable de gestionar el caso en el 
que las ventanas sean redimensionadas y hacer que los componentes se mue- 
van. Para posicionar los componentes donde se quiera, se puede indicar que 
no se quiere ningún gestor de esquemas, y luego medir y ubicar los compo- 
nentes como se quiera, usando add para visualizarlos como sigue: 


setLayout (null); 

textl = new TextField(20); 
textl. setSize(200, 50); 
textl.setlLocation(20, 20); 
add (text1); 


Esto añade un cuadro de texto de tamaño (200,50)en la localización (20, 
20) de un contenedor, como por ejemplo una ventana de una applet. Como 
veremos, se pueden añadir componentes a contenedores sin un gestor de 
esquemas, algo que es útil tener en mente si los esquemas de AWT le frustran 
demasiado. 

Un contenedor AWT muy útil es el componente Panel. Se pueden ordenar 
los componentes en un panel y luego añadir el panel, en sí mismo, al esquema 
de una applet o aplicación. En este capítulo veremos cómo se hace. 

Esto es todo. Ahora que ya hemos revisado lo que veremos en este capítu- 
lo, es el momento de pasar a la siguiente sección. 


Usar cuadros de texto 


"Hey", dice el programador novato, "quiero permitir a los usuarios escri” 
bir una clave secreta, pero ese maldito Johnson se queda mirando por encima 
del hombro de la gente y ve lo que escriben”. "Eso tiene fácil arreglo", le 
dice. "Basta con poner el carácter deecho del cuadro de texto a un asterisco u 
otro carácter similar. ¡Problema resuelto!" 

En el capítulo anterior, vimos y usamos los cuadros de texto; estos com? 
ponentes pueden visualizar una sola línea de texto, y el usuario puede 
editarlo. Este es el diagrama de herencia de la clase de cuadros de texto, 
TextField: 


java, awt TexbOonponerni 


| va, AWE TextField 


Se pueden ver los constructores de esta clase en la tabla 7.1 y sus métodos! 
en la 7.2. 


Tabla 7.1. Constructores de la clase TextField. 


Constructor Descripción 

TextField() Construye un nuevo cuadro de texto. 

TextField(intcolumnas) Construye un nuevo cuadro de texto vicio 
con el número de columnas indicado. 

TextField(Stringtexto) Construye un nuevo cuadro de texto oc 
texto indicado. 

TextField(Stringtexto, int Construyeun nuevocuadro de texto inicia- 

columnas) lizado con eltexto indicado y con el núrriero 
de columnas especificado. ] 


Tabla 7.2. Métodos de la clase TextField. 


Método Descripción 
void addActionListener Añade el ActionListenerindicado para re- 
(ActionListener ) cibir eventos. 
void addNotify () Crea el compañero del objeto cuadro {ë 
texto. 
boolean echoCharlsSet() Indica si el cuadro de texto tiene puesto? UN 


carácter para utilizarlo como echo. 


Método 


intgetColumns() 
char getEchoChar() 
Dimension getMinimumSize() 


DimensiongetMinimumSize 
(int columnas) 


DimensiongetPreferredSize() 


DimensiongetPreferredSize 
(int columnas) 


Dimension minimumSize() 


Dimension minimumSize 
(int columnas) 


protected String paramString() 
DimensionpreferredSize() 


Dimensionpreferredsize 
(intcolumnas) 


| protected voidprocessAction- 
Event(ActionEvent e) 


protected voidprocessEvent 
(A WTEvent e) 


voidremoveActionListener 
(ActionListener 9 


voidsetColumns(int columnas) 


void setEchoChar(char c) 


Descripción 


Obtiene el número de columnas del cuadro 
de texto. 


Obtiene el carácter que se utiliza como 
echo. 


Obtiene las dimensiones mínimas para el 
cuadro de texto. 


Obtiene las dimensiones mínimas de un 
cuadro de texto con el númerode columnas 
indicado. 


Obtiene el tamaño preferido del cuadrode 
texto. 


Obtiene el tamaño preferido del cuadrode 
texto con el númerodecolumnas indicado. 


Obsoleto. Reemplazado porgethninimum- 

Size(). 

Obsoleto. Reemplazado porgethninimum- | 
Size(inh. 

Obtiene la representación en cadena del 

estado del cuadro de texto. 

Obsoleto. Reemplazado porgetpreferred- 

Size(). 

Obsoleto. Reemplazado porgetpreferred- 

Size(int). 


Procesalos eventos ocurridos en el cuadro 
detexto, enviándolos alos objetosAction- 
Listener. 


Procesa eventos en el cuadro de texto. 


Elimina el action listenerindicado, para 
que no reciba más eventos. 


Establece el número de columnas del 
cuadro de texto. 


Establece el carácter echopara el cuadro 
de texto. 


Método Descripción 


void setEchoCharacter(char c) Obsoleto. Reemplazado porsetEchoChar- 


(char). 


void setText(String t) Indica el texto que va en el cuadro de tex- 
to. 


Veamos un ejemplo. En este caso, se creará un cuadro de texto para una- 
clave que visualizará un asterisco (*) cada vez que el usuario escriba un 
carácter. Puede que se pregunte cómo se podrá leer la clave escrita. La 
respuesta es utilizando el método getText del cuadro de texto, que hereda de 
la clase Component. De hecho, se añadirá un segundo cuadro de texto en este 
programa y se visualizará la clave cuando el usuario pulse la tecla Intro. 
Empezamos añadiendo dos cuadros de texto, de 30 caracteres cada uno: 


import java.applet.Applet; 
import java.awt.*; 
import java.awt.event.*; 


public class clave extends Applet implements ActionListener 


I 
public TextField textl; 
public TextField text2; 


public void inito0 

I 
texti = new TextField(30); 
add (text1) 5 
text2 = new TextField(30); 
add (text2):5 
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A continuación, se establece que el carácter echo en textl (el cuadro de 
* E . . 
texto de la clave)es y se añade un action listener a ese cuadro de texto: 


public void inití) 
( 
textl = new TextFieldí30); 
add (text1) ; 
text2 = new TextField(30); 


add (text2); 


tewtcl se tEochochari(**'15 
testl.adidictiontistenaritbial; 
| 


Cuando el usuario pulsa la tecla Intro, se llama al método actionPerjiormed, 
por lo que sobrescribimos dicho método para establecer que el texto en el 
segundo cuadro de texto es el del componente de la clave: 


public void actionPerformed (ActionEvent e) 
if (e.getSource0 == textl)f 


text2.setText (textl.getText ()); 
1 


open sesarne 


Figura 7.1. Leer claves en cuadros de texto. 


El resultado de este código se muestra en la figura 7.1. Cuando el usuario 
escribe una clave en el cuadro de texto de la parte superior y pulsa la tecla 
Intro, esa clave aparece en el otro cuadro de texto (no es exactamente lo que 
se llamaría seguridad). Se puede ver este ejemplo en el CD de ejemplo de este 
libro, en el fichero clave.java. 


Usar etiquetas 


Las etiquetas AWT son como los cuadros de texto, salvo que el usuario no 
puede editarlas. Se pueden utilizar las etiquetas para presentar texto que no se 
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puede editar, o, como su nombre indica, para etiquetar otros componentes. 
Este es el diagrama de herencia de la clase Label: 


java. lang.Object 
Ijava.awt.Component 
Ijava.awt.Label 


En la tabla 7.3 se pueden ver los constructores de la clase Label, y sus 


métodos en la tabla 7.4. 


Tabla 7.3. Constructores de la clase Label. 


Constructor 


Labelo 
Label(Stringtexto) 


Label(Stringtexto, intalineación) 


Descripción 


Construye una etiqueta vacía. 


Construye una nueva etiquetacon el 
texto indicado, justificados laizquier- 
da. 


Construye una nueva etiqueta que 
presenta la cadena especificadacon 
la alineación indicada. 


Tabla 7.4. Métodos de la clase Label 


Método 


| void addNotifyO 
int getAlignment0 


String getText() 


| protected String paramString() 


void setAlignment(intalineación) 


void setText(String text) 


Descripción 
Crea el compañerode esta etiqueta. 


Obtiene la alineación actual de esta 
etiqueta. 


Obtiene el texto de esta etiqueta. 


Devuelve la cadena que representa 
el estado de la etiqueta. 


Fija la alineación de esta etiqueta a 
la que se especifica. 


Establece el texto de esta etiqueta al 
texto indicado. 


El texto de una etiqueta se puede justificar pasándole al constructor de la 
etiqueta los campos Label.LEFT, Label-CENTER y Label-RIGHT. 
Esto es un ejemplo que crea tres etiquetas con las posibles alineaciones de 


texto: 


import java.applet.Applet; 
import java.awt.*; 


import java.awt.event.*; 


public class etiqueta extends Applet 


( 
Label labell; 


Label label2; 
Label label3; 


public void inito0 


{ 


labell = new Label (";Hola desde Java!", Label. LEFT); 
add (labell1) ; 

label2 = new Label ("iHola desde Java!", Label. CENTER); 
add (label2); 


label3 = new “abel ("iHoladesde JavaiU, Label. RIGHT); 
add (label3); 


Saj Applet Viewer eli. PES 
Applet 


hola desde Javai 
hola desde Javal 


hola desde Javal 


Applet started 


Figura 72. Justificación de texto en una etiqueta. 


El resultado de esta applet se muestra en la figura 7.2. Este ejemplo se 
puede encontrar en el CD, en el fichero etiqueta.java. 


Usar botones 


"Quiero hacer que los usuarios interactúen con mi programa", dice el 
programador novato. " Quiero dejarles que indiquen lo que quieren hacer 
simplemente con un clic de ratón, quiero que puedan seleccionar una acción 
rápida y fácilmente, quiero...” "Botones", le contesta. "Lo que quiere son 
botones". "Cierto, " responde PN. 


Todo usuario de GUI está familiarizado con los botones, esos controles 
elementales sobre los que se hace clic para indicar a un programa que debe 
empezar a realizar alguna acción; por ejemplo, podría permitir al usuario 
hacer clic sobre un botón para cambiar el color de fondo de una aplicación. 
Los botones están soportados en la clasejava.awt.Button. Esta es la jerarquía 
de la clase: 


1 F 
lang 
W- mponen 


Los constructores de la clase Button se muestran en la tabla 7.5, y sus 
métodos en la tabla 7.6. 

Para gestionar los eventos de los botones se usa la interfaz ActionListener, 
como vimos en el capítulo anterior. Esta interfaz tiene un único método, 
actionPerformed, al que se le pasa un objeto de la clase ActionEvent cuando 
se hace clic sobre el botón: 


void actionPerformedíActionEvent e) 


( 


Tabla 7.5. Constructores de la clase Button. 


Constructor Descripción 

Button Construye un botón sin etiquet:1 

Button(String etiqueta) Construye un botón con la etiqueia 
indicada. 


--_-_a G yy 
Tabla 7.6. Métodos de la clase Button. 


Metodo Descripción 


void addActionListener(ActionListeneri) Añade el ActionListener indicda 
para recibir eventos del botón. 


void addNotify () Crea el compañero del botón. 

String getActionCommand() Obtiene el comando del evento pro- 
ducido por el botón. 

String getLabel() Obtiene la etiqueta del botón. 

protected String paramString() Obtiene la cadena que representa 


el estado del botón 


Descripción 


protected void processActionEvent-  Procesalos eventos que tienen lugar | 
(ActionEvent e) en el botón, enviándolosalos objetos 
ActionListenerregistrados. 


protected voidprocessEvent Procesa eventos del botón. 

(A WTEvent e) 

void removeActionListener(Action- Elimina el actionListenerpara que 
Listener ) no pueda recibir eventos del botón. 
void setActionCommand(String Establece el nombre del comando 
comando) para el evento producido por el botón. 
void setLabel(String etiqueta) Fija la etiqueta del botón para ser la 


cadena indicada. 


Este es el diagrama de la herencia de la clase ActionEvent: 


Todos los métodos de la clase ActionEvent se muestran en la tabla 7.7. 


Tabla 7.7. Métodos de la clase ActionEvent. 


Método i Descripción 

String getActionCommand() Obtiene la cadena del comando. 

int getModifiers() Obtiene las claves del modificador, 
mantenidas durante el evento. 

String paramString() Obtiene una cadena que identifica el 
evento. 


Como vimos en el capítulo anterior, hay dos formas principales de deter- 
minar qué botón se seleccionó, usando el método getSource y usando coman- 
dos. Primero, veremos cómo se hace esto con getSource.He aquí un ejemplo 
con un botón que, cuando se hace clic sobre él, se visualiza el mensaje "iHola 
desde Java!" en un cuadro de texto (observe que se ha registrado un action 
listener con el botón y se investiga cuál es el botón sobre el que se ha hecho 
clic usando el método getSource antes de poner el texto apropiado en el 
cuadro de texto). 


import java.applet.Applet; 
import java.awt.*; 


import java. .awt.event.* 


public class boton extends Applet implements ActionListener ( 


MIDTH=41 
MELDGOT 15 
“J 
<APPLET 


TextField textl; 
Button buttonl; 


public void init() 


{ 
textl = new ~extField(20); 
add (text1) 3 


buttonl = new Button ("¡Haga clic aqui!'!; 
add (button1); 


butonl.add-ction-istener (this); 
1 


public void actionPerformed (ActionEvent event) 
1 
String msg = new String ("¡Holadesde Java!"); 
if (event.getSource() == buttonl)C 
textl.setText (msg) ; 
1 


1 


El resultado de este código se muestra en la figura 7.3. Esta applet se 
puede encontrar en el CD, boton.java. 
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Figura 7.3. Gestionar el hacer clic en los botones. 


También se pueden usar comandos con botones; en el capítulo anterior, 
vimos que el comando asociado por defecto a cada botón es su inscripción. 
Sin embargo, dado que estas inscripciones pueden cambiar durante la ejecu- 
ción del programa (por ejemplo, usando el método setlabel), se debería 
asociar un comando con el botón en sí mismo. Se puede dar a un botón un 
comando de tipo string con el método setActionCommand como sigue: 


import java.applet.Applet; 
import java.awt.*; 
import java.awt.event.*; 


<APPLET 
public class boton2 extends Applet implements ActionListener ( 


“extFieldtextl; 
Button buttonl; 


public void inito0 


( 
textl = new TextField(20); 


add (text1l); 

buttonl = new Button ("iHaga clic aquí!"); 
add (buttonl):; 
b-ttonl.setActionC-nd(-Boátfnetado"); 
buttonl.add-ctionListener (thic); 


} 


Ahora, en el método actionPerformed, se puede obtener el comando para 
el botón sobre el que se hizo clic, usando el métodogetActionCommand. Si el 
botón sobre el que se hizo clic es el de la derecha, se puede situar el mensaje 
en el cuadro de texto, como sigue: 


public void actionPerformed(ActionEvent eventi 
I 
String msg = new String (myBoladesde Javal"); 
String command = event.getActionC-nd0; 


fico, aquala (¿Botón apretado" 111 
Laxtl. setTant (mg) 


Esta appletse puede encontrar en el CD en boton2.java. 


Usar casillas de activación 
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"Ahora, tengo otro problema", dice el programador novato. "Quiero que 
los usuarios puedan seleccionar de qué quieren una pizza, por lo que me 
gustaría que cuando se haga clic sobre un botón, éste aparezca pulsado para 
que los usuarios sepan lo que ya han seleccionado". "No hay ningún proble- 
ma", le dice. "No utilice botones". "¿No?" pregunta PN. "No, " le dice. 
"Utilice casillas de activación en su lugar". 

Una casilla de activación permite al usuario seleccionar opciones. Cuando 
el usuario hace clic en una casilla de activación, algún tipo de indicación 
visual, como una marca de activación (el indicador varía con el sistema 
Operativo cuando se usa AWT), se utiliza para indicar que la opción está 
seleccionada. Si se hace clic otra vez en la casilla de activación, se deselecciona. 
En AWT, las casillas de activación están soportadas por la clase 
java.awt. Checkbox, que tiene el siguiente diagrama de herencia: 


Tabla 7.8. Constructores de la clase Checkbox. 


Constructor Descripción 


Crea una casilla de activación sin 
etiquetas. 


Checkbox(Stringetiqueta) Crea una casilla de activación con la 
etiqueta especificada. 


Checkbox(Stringetiqueta,boolean Crea una casilla de activación con la 
estado) etiqueta especificada y fija el estado. 


Checkbox(Stringetiqueta, boolean Crea una casilla de activación en el 
estado, CheckboxGroupgrupo) grupo indicado y fija el estado. 


Checkbox(Stringetiqueta, Check- Construye una casilla de activación 
boxGroupgrupo, booleanestado) con la etiqueta indicada en el grupo 
especificado. 


Tabla 7.9. MBtodos de la clase CheckBox. 


Metodo 


Descripción 


void addltemListener(ttemListener 1) Añade el item listener indicado a la 
casilla de activación. 


void addNotify () 
CheckboxGroupgetcheckbox- 
Grou~O 

String getlabelo 


Object[]getSelectedObjects() 


boolean getState() 


protected String paramStringO 


protected void processEvent 
(AWTEvent e) 


protected void processltemEvent 
(IternEvent e) 


void rernovelternListener 
(ItemListener 3 


void setCheckboxGroup 
(CheckboxGroup 9) 
void setLabel(String etiqueta) 


void setState(boo1ean state) 


Crea el compañero de la casilla de 
activación. 


Crea un grupo de casillas de activa- 
ción. 

Obtiene la etiqueta de la casilla de 
activación. 


Obtiene un array (de longitud 1) que 
contiene la etiqueta de la casilla de 
activación (o null si no se ha se- 
leccionado). 


Determina si la casilla de activación 
está en estado seleccionado ono se- 
leccionado. 


Obtiene una cadena que representa 
el estado de la casilla de activación. 


Procesa eventos en la casilla de acti- 
vación. 

Procesa los eventos de itemsque se 
producen en la casilla de activación, 


enviándolos a cualquiera de los obje- 
tos ItemListener registrados. 


Retira el item listenerindicado, para 
que no reciba más eventos de la | 
casilla de activación. 


Establece el grupo de casillas de 
activación para el grupo dado. 


Fija la etiqueta de la casilla de activa- 
ción en esta cadena. 


Fija el estado de la casilla de activa- 
ción en el estado dado. 


En la tabla 7.8 se pueden encontrar los constructores de la clase Checkbox 
y sus métodos en la tabla 7.9. Observe, en particular, que se puede poner el 


ùi 
E 
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estado de una casilla de activación con setState y obtener el estado con get- 
State. 

Veamos un ejemplo en el que se añaden cuatro casillas de activación a una 
applet, y cuando el usuario hace clic sobre una de ellas, se utiliza un cuadro 
de texto para indicar que se ha seleccionado. Observe que las casillas de 
activación no utilizan la interfaz ActionListener como lo hacen los botones; 
en su lugar, usan la interfaz ItemListener, que sirve para gestionar los compo- 
nentes que pueden ser seleccionados o deseleccionados. La interfaz 
ItemListener sólo tiene un método, itemStateChanged, al que se le pasa un 
parámetro de la clase ItemEvent: 


void itemStateChanged(ltemEvent e) 


Los métodos de la clase ItemEvent se pueden encontrar en la tabla 7.10. 
Asíes como se añaden casillas de activación en unaapplet y un ItemListener 
a cada una de ellas: 


import java.applet.Applet; 
import java.awt.*; 
import java.awt.event.*; 


public class casillas extends Applet implements ItemListener ( 


Checkbox checkbox1, checkbox2, checkbox3, checkboxl; 
TextField textl; 


public void inito0 


I 


checkboxl = new Checkbox("1m)5 
add(checkboxl) - 

checkboxl .addItemGistener (this); 
checkboxl1 = new Checkbox ("1W) ; 


Tabla 7.10. Métodos de la clase ltemEvent. 


Método Descripción 
Object getitamp) Obtiene el elemento afectado por el 
evento. 


| ItemSelectable getltemSelectable() Obtiene el originador del evento. 


Método Descripción 


int getStateChange0 Obtiene el tipo de cambio de estado 
(es decir, seleccionado o quitada la 
selección). 

String paramString() Obtiene la cadena que coincide con 
el evento. 


add (checkbox2 1 
checkbox2 . addItemListener (this); 
checkbox3 = new Checkbo- ("3-); 
add (checkbox3) - 
checkbox3 . addItemListener (this); 
checkbox4 = new Checkbo- ("4-); 
add (checkbox9) : 
checkbox4 . addIt-istener (this); 
textl = new TextField(30); 
add (text1) ; 

1 


Ahora, sobrescribimos el método itemStateChanged, para determinar so- 
bre qué casilla de activación se pulsó, usando el método getItemSelectable 
del objeto ItemEvent: 


public void itemStateChanged (1temEvent e) 
( 

if(e.getltemSelectable() == checkboxl) ( 
textl.setText ("¡Casillade activación 1 pulsada!"); 

) else if(e.getltemSelectable0 == checkbox2) [ 
textl.setText ("-Casillae activación 2 pulsada!"); 

) else if(e.getltemSelectable() == checkbox3)( 
textl.setText ("iCasilla de activación 3 pulsada!"); 

) else if(e.getltemSelectable0 == checkbox4)( 
textl.setText ("¡Casillade activación 4 pulsada!"); 


) 


Ahora, ya sabemos cómo utilizar el método getStateChanged del objeto 
ItemEvent para determinar si una casilla de activación está seleccionada o no. 
Este método devuelve Checkbox.SELECTED o Checkbox. DESELECTED. Y, 
por supuesto, se puede usar el método getState de la casilla de activación para 
hacer la misma determinación. Además se puede establecer el estado de la 
casilla de activación con el método setState. 

El resultado de esta applet se muestra en la figura 7.4. Se puede encontrar 
en el CD, en casillas.java. 

Debido a que es tedioso tener tantas sentencias ifen la escala if-else del 
código anterior, se puede visualizar únicamente la casilla de activación sobre 
la que se ha hecho clic obteniendo su etiqueta directamente, como sigue: 
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import Java.applet.Applet; 
import java.awt.*:; 
import jJava.awt.event.*; 


[A tardar chari mi- ES 
| dec 
rl v2 r4 


~Castllale aclivacion 2 pulsada1 


Applet stafied 


Figura 7.4. Gestionar el hacer clic sobre las casillas de activación. 


public class casillas2 extends Applet implements ItemListener { 


Checkbox checkboxl, checkbox2, checkbox3, checkbox4; 
TextField textl: 


public void init() 

' checkboxl = new Checkbox ("1"); 
add (checkbox1); 
checkboxl.addItemListener (this); 
checkbox2 = new CheckboxíM2"); 
add (checkbox3 ; 
checkbox2.addItemLictener (this); 
checkbox3 = new Checkboxín3"); 
add (checkbox3); 
checkbox3.addItemListener (this); 
checkbox4 = new Checkbox ("4"); 
add (checkbox4); 
checkbox4.addItemListener (this); 
textl = new TextField(35); 
add (text1); 


public void itemStateChanged(1temEvent e) 
{ 


textl.setText ("rCasilla de activación Ma 


( (Checkbox) e.getItemSelectable ()) .getlLabel () + "pulsa- 
da!"); 


Esta nueva versión de la applet aparece en casillas.java en el CD. Hay otro 
tipo de casilla de activación que se puede utilizar, los botones de opción, y 
los revisaremos en la siguiente sección. 


“Usar botones de opción 


"Uh-oh", dice el programador novato, "tengo otro problema. Puse casillas 
de activación en mi programa para que los usuarios pudieran seleccionar el 
día de la semana, y un usuario seleccionó miércoles y viernes". "Bien", le 
contesta, "debería usar botones de opción, en lugar de casillas de activación 
para visualizar opciones excluyentes, como el día de la semana". 

En la programación AWT, los botones de opción son un tipo especial de 
casilla de activación, y se usan en grupos. Sólo un botón de opción de un 
grupo puede ser seleccionado de una vez; cuando el usuario selecciona un 
botón de opción en un grupo, el resto del grupo es automáticamente desacti- 
vado. 


Cuando se añaden casillas de activación a un grupo, se convierten en 
botones de opción de forma automática. AWT soporta grupos de casillas de 
activación con la clase CheckboxGroup. Esta clase sólo tiene un constructor, 
CheckboxGroup, que no tiene parámetros, cuyos métodos se verán en la 
tabla 7.11. Observe que, puesto que los botones de opción son realmente 
casillas de activación, se pueden usar los métodos Checkbox, como getState 
y setstate. 


Tabla 7.11. Métodos de la clase CheckboxGroup. 


Método Descripción 
Checkbox getCurrent() Obsoleto. Sustituido por getselec- 
tedCheckBox(). 


Checkbox getSelectedCheckbox() Obtiene la casilla de activación que 
actualmente estaseleccionada dentro 
del grupo. 


void setCurrent(Checkbox box) Obsoleto. Reemplazado porsetselec- 
tedCheckbox(Checkbox). 


void setSelectedCheckbox Establece la casilla de activación ac- 
(Checkbox box) tualmente seleccionada en este grupo. 


Método Descripción 


String toString() Devuelve una representación tipo 


stringdel grupo, incluyendo el valor de 
su selección actual. 


Observe, por ejemplo, que se puede determinar qué botón de opción está! 
seleccionado en un grupo, con el método getSelectedCheckbox de la clase 
CheckboxGroup, y se puede inicializar con uno seleccionado con el método 
setSelectedCheckbox. 

Este es un ejemplo en el que se crea un grupo de casillas de activación 
llamado radios, y se añaden cuatro botones de opción a ese grupo. Se añade 
un botón de opción a un grupo de casillas de activación añadiéndolo al grupo, 
pasándolo como parámetro al constructor de la casilla de activación, que 
convierte la casilla de activación en un botón de opción. Este es el código: 

import java.applet.Applet; 


import java.awt.*; 
import java.awt.event.*; 


public class botondeopcion extends Applet implements ItemListener ( 


CheckboxGroup radios; 
Checkbox radiol, radio2, radio3, radio4; 
TextField textl; 


public void hit () 
1 


radios = new CheckboxGroup (); 


radiol = new CheckboxGroup ("1", false, radio); 
add (radiol); 
radiol.addItemListener (thie); 


radio2 = new CheckboxGroup ("2". false. radio); 
add (radio2) 5 

radio2.addItemListener (this); 

radio3 = new Checkbo-Group (~3" false, radio); 
add (radio3) ; 

radio3.addItemListener (this); 


radio4 = new CheckboxGroup (*4*, false. radio); 


ndd [(radiod ls 
codiod. additenLlistenar(thinip 


banti = ase Textrisld(25)5 
addict ll 


Observe que se ha añadido unItemListener a cada botón de opción, por lo 
que se puede implementar el método itemStateChanged para indicar qué 
botón de opción ha sido seleccionado, como sigue: 


public void itemStateChanged (1temEvent e) 


{ 
textl.setTe-t (~; Botóme opción " + 


( (Checkbox) e.getItemSelectable ()) .getLabelo + "pulsa- 
aOlm); 


El resultado de este código se muestra en la figura 7.5, y podrá encontrar 
esta applet en el CD como botondeopcion.java. 

Ahora que estamos trabajando con componentes en programas visuales, es 
hora de tener en cuenta cómo se ordenan estos componentes, y trataremos de 
hacerlo en los siguientes puntos. 


[appt Yasa intro op 
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Figura 7.5. Gestionar el hacer clic en botones de opción. 


Esquemas de flujo (flow layout) 


"Uh-oh", dice el programador novato, "de nuevo Java está graciosillo". 
"¿Qué ha hecho ahora?" le pregunta. PN dice, "Bien, estoy creando una 
calculadora para multiplicar y quiero que todos los cuadros de texto se alma- 
cenen verticalmente, pero se ordenan en filas". "Eso se debe a que está 
utilizando un esquema de flujo (flow layout)", le dice. 
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Java tiene un número de gestores de esquemas AWT que gestionan cómo s e 
visualizan y se instalan los componentes en los contenedores. Por defecto, las 
applets usan elfíow manager, que ordena los componentesigual que lo hacen los 
procesadores con el texto, incluyendo la ruptura de la palabra al pasar de línea. 


Tabla 7.12. Constructores de la clase FlowLayout. 
Constructor Descripción 


FiowLayoui} Construye un nuevo flow layout 
con alineación centrada. El mar- 
gen horizontal y vertical será de 5 
pixels. 


FlowLayout(intalign) Construye un nuevo flow layout 
con la alineación dada. El margen 
horizontal yverticalserá de 5 pixels. 


FlowLayout(int align, int hgap, int vhap) Crea un nuevo flow layout, con la | 
alineación dada y los márgenes | 
horizontal y vertical dados entre 
los componentes. 


Tabla 7.13. Métodos de la clase FlowLayout. 


Método Descripción 
voidaddLayoutComponen t(String Añade al esquema el componente. | 
nombre, Cornponent cornp) especificado. 
int getAlignment() Obtiene la alineación del esquema. | 
int getHgap() Obtiene la separación horizontal | 


entre los componentes. 


int getVhap() Obtiene la separación vertical | 
entre los componentes. 


void layoutContainer(Container target) Pone el contenedor. 


Dirnension minirnurnLayoutSize Devuelve las dimensiones míni- 

(Container target) mas necesarias para poner los | 
componentes en el contenedor 
target. 

Dirnension preferredLayoutSize Devuelve las dimensiones preferi- 

(Container target) das para el esquema, dados los 


componentes en el contenedor 
target. 


Método Descripción 


voidremoveLayoutComponent Elimina el componente del esque- 
(Component comp) ma. 

void setAlignment(int align) Fija la alineación. 

void setHgap(int hgap) Fija la separación horizontal entre 


los componentes. 


void setVgap(int vgap) Fija la separación vertical entre 
los componentes. 


- String toString() Devuelve la representación de tipo 
stringde este objeto FlowLayout. 


Los constructores de la clase FlowLayout aparecen en la tabla 7.12 y sus 
métodos en la tabla 7.13. 

Para tener algún control sobre cómo elflow layout ordena los componen- 
tes, se puede especificar su alineación utilizando los siguientes campos 
FlowLayout: 


e CENTER: Indica que cada fila de componentes debería estar centrada. 


e LEADING: Indica que cada fila de componentes debería estar justifica- 
da a la primera esquina del contenedor. 


e LEFT: Indica que cada fila de componentes debería estar justificada a la 
izquierda. 

e RIGHT: Indica que cada fila de componentes debería estar justificada a 
la derecha. 


+ TRAILING: Indica que cada fila de componentes debería estar justifica- 
da a la siguiente esquina del contenedor. 


Por defecto, el flow layout centra cada componente de la fila, pero aquí 
podemos ver cómo se crea un nuevoflow layout que justifica los componen- 
tes a la derecha usando el método setlayout: 


import java.applet.Applet; 
import java.awt. a 
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public class flow extends Applet ( 


1 


“extFielotextl, text2, text3; 


public void init()( 

setLayout (new Flow-ayout (FlowLayout .RIGIiT); 
textl = new TextField(10); 

add (text1) ; 
text2 = new TextField(10); 
add (text2j ; 
text3 = new TextField(10); 
add (text3) ; 


Una vez que se han añadido algunos cuadros de texto a este nuevo gesto? 
se puede ver que están justificadosa la derecha, como se muestra en la figura 7.6. 


Ei tenini Mura Bor claer 


Appie slated 


Figura 7.6. Componentes de un flow layout justificados a la derecha. 


Sin embargo, algunas veces un flow layout no es correcto. Por ejemplo: 


echemos un vistazo a esta applet, que presenta la calculadora que el progra- 
mador novato estaba intentando crear: 


import Java.applet.Applet; 
import Java.awt.*; 
import jJava.awt.event.*; 


public class multiplicadora extends Applet implements ActionListener ( 


TextField textl, text2, text3; 
Label multiplylabel; 
ButtOn bl; 


public void inito 


{ 
textl = new TextField(10); 


additextl) ; 


multiplylabel = new Label("*"); 
add (multiplylabel); 


text2 = new TextField(10); 
add (text2) ; 


bl = new Button("="); 
add (b1); 
bl.addActionListener (this); 


text3 = new TextField(10); 
add (text 3); 


public void action-erformed(ActionEvente) ( 
if (e.getSource() == b1)l 
int product = Integer.parselnt (textl.getText0) 
Integer .parseInt (text2.getTexto Í; 
text3.setText (String.value0f (product)); 


} 


El resultado se muestra en la figura 7.7, y esta applet está en 
multiplicadora.java en el CD. Como se puede ver en la figura, los cuadros de 
texto están ordenados según elflow layout, y el resultado es lo que el progra- 
mador novato buscaba. Echaremos un vistazo a otro gestor de esquemas, el 
grid layout, próximamente. 


Grid layouts 


"Entonces, ¿cómo arreglo mi calculadora para multiplicar? Los cuadros de 
texto no están en su sitio", pregunta el programador novato. "Tiene que usar 
un gestor de esquemas diferente, " le contesta, "el grid layout". 

El grid layout permite añadir componentes a un contenedor, 
posicionándolos en una cuadrícula. Al grid layout se le dan las dimensiones 
de la cuadrícula, como por ejemplo, cinco filas y cinco columnas, y cuando se 
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añadan componentes a este esquema, se hará empezando por la izquierda de 
la primera fila. 


E statied | 


Figura 7.7. Primer intento de una calculadora para multiplicar. 


Una vez que la primera fila esté rellena, los componentes se sitúan en 1 
primera columna de la segunda fila y así sucesivamente. Observe que cada 
componente tiene el mismo tamaño y dimensiones. Este es el diagrama de 
herencia para el grid layout: 


a, MATE. LF AOL AY 


En la tabla 7.14 se encuentran los constructores de la clase GridLayout 7 
sus métodos en la tabla 7.15. 


Tabla 7.14. Constructores de la clase GridLavout. 


Constructor Descripción 


GraLayout Crea un grid layout en una fila, con 
una columna por componente. 


GridLayout(intfilas, intcolumnas) Crea un grid layout con el número 
de filas y de columnas indicados. 


GridLayout(intfilas, intcolumnas, Crea ungridlayoutcon el número de 
inthgap, int vgap) filas, columnas y separación dados. 


Tabla 7.15. Métodos de la clase Gridlayout. 


voidaddLayoutComponent(String Añade al esquema el componente. 
nombre, Componentcomp)dado 


intgetColumns() Obtiene el número de columnas del 
esquema. 


Método 


intgetHgap() 
intgetVgap() 


void layoutContainer(Container 
padre) 


Dimension minimumLayoutSize 
(Containerpadre) 


DimensionpreferredL ayoutSize 
(Containerpad re) 


voidremoveLayoutComponent 
(Component comp) 

void setColumns(int cols) 

void setHgap(int hgap) 


void setVgap (int vgap) 


void setRows(ínt filas) 


String toString() 


Descripción 


Obtiene la separación horizontal en- 
tre los componentes. 


Obtiene la separación vertical entre 
los componentes. 


Pone el contenedor usando el esque- 
ma. 

Determinaeltamaño mínimo delcon- 
tenedor usando el grid layout. 


Determina el tamaño preferido del 
contenedor usando el grid layout. 


Elimina del esquema elcomponente 
indicado. 


Establece el número de columnas 
en el esquema. 


Establece la separación horizontal 
entre los componentes. 


Establecela separaciónverticalentre 
los componentes. 


Establece el número de filas del es- 
quema. 


Obtiene una representación de tipo 
string del esquema. 


Este es un ejemplo en el que se crea una cuadrícula de cinco filas y una 
columna, pasando esas dimensiones al constructor del gestor grid layout 
como GridLayout(5,!). Cuando se inicia la .adición de componentes a este 
esquema, serán almacenados uno encima de otro. 


import java.applet.Applet; 
import java.awt.*; 
import java.awt.event.*; 
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</APPLETa 7 
public class multiplicadora2 extends Applet implernents ActionListener 


Text-ieldtextl, text2, text3; 
Label multiplylabel; 
Button buttonl; 


public void init0 
( 
setLayout (new GridLayout (5.1) ); 


textl = new TextFieid(i0); 
add (text1); 


multiplylabel = new Label ("*", Label-CENTER); 
add(multiplylabel); 


text2 = new -extFieid(10); 
add (text2); 


buttonl = new Button("="); 
add (buttonl)'; 
buttonl.addActionListener (this); 


text3 = new TextFieid(10); 
add (text 3); 


public void actionPerformed(ActionEvent e) 


{ 


if(e.getSource0 == buttonl){ 
int product = Integer.parselnt (textl.getText0) j 
integer .:parsernt [texta.getText 11): 
tet aetas Serios, va lueot product 


Lal EL] 


des ara 


Figura 7.8. Segunda versión de la calculadora para multiplicar. 


El resultado de este código se muestra en la figura 7.8. Como se puede ver 
en la figura, los componentes de esta applet se almacenan verticalmente, 
como se suponía. 

Una forma de trabajar con esquemas es dividir los componentes del pro- 
grama en paneles y añadir dichos paneles a los esquemas. Esto hace que se 
tenga más control sobre dónde van a ir los controles. Echaremos un vistazo a 
los paneles en el siguiente punto. 


Usar paneles 


El programador novato todavía no está satisfecho con los problemas que 
tiene con los esquemas y dice, "Necesito afinar el control en mi esquema, 
tengo muchos componentes que visualizar". "De acuerdo, " le dice, "para 
tener más control, puede usar los paneles de Java". "¡Estupendo! Cuénteme 
todo eso", contesta PN. 

La clase Panel de Java es un contenedor que se puede usar en los esque- 
mas. Se añaden componentes a un panel y luego se añade ese panel al esque- 
ma. 

Dado que los paneles son contenedores, se pueden fijar sus gestores usan- 
do los métodos setlayout. Los paneles, por sí solos, no son contenedores 
visuales, no tienen bordes, por ejemplo, y sólo existen para contener compo- 
nentes. Este es el diagrama de herencia para la clase Panel: 


java. lang.Object 
Ijava.awt.—omponent 
ljava.awt.Container 
Ijava.awt.-anel 


El constructor de la clase Panel se muestra en la tabla 7.16 y su método en 
la tabla 7.17. 


Tabla 7.16. Constructor de la clase Panel. 


Constructor Descripción 


Panel(LayoutManagerlayout) Crea un nuevo panel con el layout es- 
pecificado. 


Tabla 7.17. Método de la clase Panel. 


Método 


Descripción 


addNotify () Crea el compañero del panel. 


Este es un ejemplo en el que se deriva una nueva clase, buttonPanel, de d 
clase Panel, y se añaden algunos botones al panel en el constructor buttonpanel: 


import Java.applet.Applet; 
import java.awt.*:; 


class buttonpanel extends Panel 
I 
Button buttonl, button2, button3, button4; 


buttonpanel() 

{ 
buttonl = new Button("ln); 
add (buttonl); 
buttonl = new Button("2"); 
add (button2) ; 
button3 = new Buttonín3"); 
add (button3); 
buttonl = new Buttonin4"); 
add (button4) ; 


) 


Ahora, se pueden ordenar paneles de esta nueva clase en un grid layo; ? 
como sigue: 


public class paneles extends Applet ( 
buttonpanel paneli, panei2, panel3, panel4, panel5, panel6; 


public void init()( 
setLayout (new GridLayout (2.31); 


panell = new buttonpanel0; 
panel2 = new buttonpanel0; 
panel3 = new buttonpanelO0 ; 
panel4 = new buttonpanel0O0; 
panel5 = new buttonpanel0; 
panel6 s new buttonpanelo; 


addípáñelli; 
addípañell): 
addípaneldi 
add(panalá)l; 
add(pañsi5|; 
addipansl py 


El resultado de este código se muestra en la figura 7.9, y el código de esta 
applet se puede encontrar en paneles.java en el CD. Como se puede ver en 
esta figura, se ha añadido cada panel al grid layout; usando paneles se da un 
control más fino al esquema. 


Apple Wiemer pan MEE || 


Appi 
qa qa mal 
PETET 


23 a mal 
33 43 23 


Appiel started 


Figura 7.9. Ordenar componentes usando paneles. 


Border Layout 


El programador novato vuelve y dice, "¿hay más esquemas que deba 
conocer?" "Por supuesto, " le dice. "Debería conocer el border layout, por 
ejemplo". PN pregunta, "¿Ordenalos límites?" "Un poco", le dice. 

El border layout permite ordenar los componentes alrededor del borde de 
un contenedor. Es útil si se quieren soportar, digamos, barras de desplaza- 
miento y desplazar un componente central. Los border layouts son las venta- 
nas de AWT por defecto, ventanas frame, y cuadros de diálogo. Se indica 
dónde se quiere que vaya un componente pasando al constructor BorderLayout 
cadenas como "North", "East", etc. Este es el diagrama de herencia para 
BorderLayout: 


Los constructores de la clase BorderLayout se encuentran en la tabla 7.18 
y sus métodos en la tabla 7.19. 
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Tabla 7.18. Constructores de la clase Borderl ayout. 


Constructor 


BorderLayoun) 


BorderLayout(int hgap, int vgap) 


Descripción 
Construye un nuevo border layout. 


Construye un border layout con las 
separacionesentre componentesin- 
dicadas. 


Tabla 7.19. Métodos de la clase BorderLayout. 


Método 


void addLayoutComponent(Com- 
ponenf comp, Object constraints) 


void addLayoutComponent(String 
nombre, Component comp) 


int getHgap() 


Descripción 


Añade el componente al layout, 
usando el objeto dado. 


Añade al layoutel componentedado, 
con el nombre indicado. 


Obtiene la separación horizontal en- | 
tre componentes. 


floatgetLayoutAlignmentX(Container Obtiene la alineación a lo largo del 


padre) 


eje x. 


floatgetLayoutAlignmentY(Container Obtiene la alineación a lo largo del 


padre) 
int getVgap() 


void invalidateLayout(Container 
target) 


void layoutContainer(Container 
target) 


Dimension maximumLayoutSize 
(Container target) 


Dimension minimumLayoutSize 
(Container target) 


Dimension preferredLayoutSize 
(Container target) 


void removeLayoutComponent 
(Component comp) 


eje y. 
Obtiene la separación vertical entre 
componentes. 


Invalida el esquema. 
Pone el contenedor 


Obtiene las dimensiones máximas 
delesquema dados los componentes | 
en el target. 


Obtiene las dimensiones mínimas 
del esquemausando elgestorde es- | 
quemas. 


Obtiene las dimensiones preferidas 
del esquemausando el gestor de es- 
quemas. 


Elimina del esquema el componente 
dado. 


Método Descripción 


void setHgap(int hgap) Establece la separación horizontal 
entre los componentes. 


void set Vgap(intvgap) Establece la separación vertical entre 
los componentes. 


String toString() Obtiene una representación tipo 
stringdel esquema. 


Este es un ejemplo en el que se crea un panel que contiene un cuadro de 
texto y se añaden cuatro botones alrededor del borde del panel. Cuando el 
usuario hace clic sobre un botón, la applet indicará, en el cuadro de texto, el 
botón que se pulsó. 

Así es como se crea el panel que visualiza un cuadro de texto: 


import Java.applet.Applet; 
import java.awt.*; 
import java.awt.event.*; 


class textpanel extends Panel 


(H 
TextPield Textl; 
textpanel()i 
Textl = new TextField(30); 
add (Text1); 
1 
1 


Ahora se crea un border layout, situando el panel del cuadro de texto en el 
centro y añadiéndole cuatro botones alrededor del borde. Se puede especifi- 
car dónde se quiere situar un componente con cadenas como "North", "West", 
"Center", etc. Se crea el esquema como sigue: 


public class border extends Applet implements ActionListener 


I 


Button buttonl, button2, button3, button4; 
textpanel Panell: 


public void inito0 


sestLayoutiner Borderlarout (bbs 


buttonl = new B-tton(-“1-); 
add ("Northm, buttonl); 
buttonl.addActionListener (this); 


button2 = new Button("2'); 
add ("Westm, button2); 
button2.addActionListener (this); 


button3 = new Button("3"); 
add ("South", button3); 
button3.addActionListener (this); 


button4 = new Button("4"); 
add ("Eastm, button4); 
buttonl.addActionListener (this); 


Panell = new textPanel0; 
add ("Centern, Panell); 
Paneil.Textl.setlLocation(0, o); 


public void actionPerformed(ActionEvent e) 
I 
Panell .Textl.setText ("Botón » + 
( (Button) e.getSource0) .getlabeloO0 + 


" 


pulsado."); 


Botón 1 putsi 


Arole aiei 


Figura 7.10. Crear un border layout. 


El resultado de este código se muestra en la figura 7.10. Como se puedeT 
ver en esta figura, los botones aparecen alrededor del perímetro central del 
panel. 


Card Layouts 


"¿Hay más esquemas AWT?" dice el programador novato. "Claro que los 
hay", le dice, "card layout". "Veámoslo", dice PN. 

El gestor card layout visualiza los contenedores que se le pasan como 
tarjetas. A cada una se le da un nombre; luego se puede mover de una a la otra 
con el método show de card layout. Este es el diagrama de herencia para la 
clase CardLayout: 


java. lang.Object 
Ijava.awt.CardLayout 


Además del métodoshow, se pueden visualizar tarjetas específicas usando 
los métodosfirst, last, next y previous de la clase CardLayout. Los construc- 
tores de la clase CardLayout se encuentran en la tabla 7.20 y sus métodos en 
la tabla 7.21. 


Tabla 7.20. Constructores de la clase CardLayout. 


Constructor Descripción 


CardLayout() Crea un nuevo card layout. 


CardLyout(inthgap, int vgap) Crea un nuevo card layout con las 
separaciones horizontal y vertical 
marcadas. 


Tabla 7.21. Métodos de la clase CardLayout 


Método Descripción 

void addL ayoutComponent(Compo- Añade el componente al layout, 
nent comp, Object constraints) usando el objeto dado. 

void addLayoutComponent(String Añade al layoutelcomponente dado, 
nombre, Component comp) con el nombre indicado. 

void first(Containerpadre) Vaala primeratarjeta del contenedor. 
int getHgap() Obtiene la separación horizontal 


entre componentes. 


float getLayoutA lignmentX(Contai- Obtiene la alineación a lo largo del 


ner padre) eje X. 

float getLayoutAlignmentY(Contai- Obtiene la alineación a lo largo del 

ner padre) eje y. 

int getVgap() Obtiene la separación vertical entre 
componentes. 
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Metodo 


voidinvalidateLayout(Container 
target 


void last(Container padre) 


voidlayoutContainer(Container 
padre) 


Dimension maximumLayoutSize 
(Container target) 


DimensionminimumLayoutSize 
(Containerpadre) 


void next(Container padre) 


DimensionpreferredLayoutSize 
(Containerpadre) 


voidprevious(Containerpad re) 
voidremoveLayoutComponent 
(Component comp) 

void setHgap(inthgap) 

void setVgap(int vgap) 

void show(Containerpadre, 


Stringnombre) 
String toString() 


Do scripción 


Invalida el esquema. 


Va ala última tarjeta del contenedor. 


Pone el contenedor dado usando 
este cardlayout. 


Obtiene las dimensiones máximas 
del esquema dados los componentes 
en el target. 


Calcula el tamaño mínimo para el 
panel dado. 


Vaalasiguiente tarjeta del contene- 
dor dado. 


Obtiene las dimensiones preferidas 
del esquema usando este card 
layout. 


Vaala tarjeta anterior del contenedor 
dado. 


Elimina del esquema el componente 
dado. 


Establece la separación horizontal 
entre los componentes. 


Establece la separación vertical 
entre los componentes. 


Va al componente que se añadió al 
esquemacon elnombre especificado. 


Obtiene una representación tipo 
string del esquema. 


ca 


Veamos un ejemplo en el que se crea una clase panel, cardPanel, que. 
visualiza un botón, sobre el que el usuario puede hacer clic para moverse a la 
siguiente tarjeta, y una etiqueta para indicar el número de la tarjeta actual. El 
constructor de esta clase tiene dos parámetros: un objeto de la clase principal 
de applet, por lo que laapplet, en sí misma, puede gestionar los clics sobre el 
botón que se produzcan en cada panel y una representación en cadena del 
número del panel actual: 


import java.awt.*; 
import java.applet.Applet: 


import jJava.awt.event.*; 


class cardpanel extends Panel 
I 

Button button; 

Label label; 


cardPanel (card applet, String cardnumber) 


I 
button = new Button("Tarjeta siguiente"); 
button.addActionListener (applet) ; 
add (button) ; 
label = new Label ("Esta ea la tarjeta nQ " + cardnumber); 
add (label); 

1 


1 


En la clase main de la applet, se crean tres paneles de la clase cardpanel. 
Después se les añade a un card layout, dándoles los nombres "primera”, 
"segunda", y "tercera": 


public class card extends Applet implements ActionListener 
I 


int index = 1; 
CardLayout cardlayout; 
Ccardpanel panell, panel2, panel3; 


public void init() 

{ 
cardlayout = new CardLayouto; 
set~ayout (cardlayout) ; 


panell = new cardPanel (this, "uno"); 
panel2 = new cardpanel (this, —dosm ; 
panel3 = new cardPanel (this, "tres"); 


addi"primero”, panelil; 
«da *seguedo", pañal]; 
add i "tercero", panell)/ 


cardlayout . shov (this. "primero"); 


1 


Cuando el usuario hace clic sobre un botón, se puede repetir sobre las 


tarjetas disponibles, usando un índice que se incrementa y se evalúa con la 
sentencia switch: 
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public void actionPerformed (ActionEvent eventi 
i 
switch (++index) 


Case 1: 
cardlayout.show(this, "primero"); 


break; 


case 2: 
cardlayout.show(this, "segundo"); 


break; 


Case 3: 
cardlayout .show(this, "tercero"); 


break; 


1 
if (index == 3) index = 0; 


repainto; 


) 


El resultado se muestra en la figura 7.11. Cuando el usuario hace clic 
sobre el botón "Tarjeta siguiente", la applet cambia a la siguiente tarjeta del 
esquema, dando vueltas sobre las tarjetas. Veamos un card layout y cómo 
funciona; esta applet se puede encontrar en card. java en el CD. 

Hay un esquema más que vamos a revisar, grid bag layours. 

[apoiet verme 


Sioplet 


Tar-etsiguiente | 


Esta es la tarjeta n° tres 


Figura 7.11. Usar un card layout. 


Grid bag layouts 


"De acuerdo", dice el programador novato. "Ya soy un experto en 10s 
esquemas de AWT". "No, todavía no", le dice. "No hasta que sea un experto 
en grid bag layout". 

Grid bag layouts son los esquemas AWT más complejos y flexibles, Y 
permiten especificar, más exactamente que cualquier otro gestor de esque- 


Método Descripción 


l 
J 


java.lang. Object 
ljava.awt.GridBagLayout 


mas, el lugar donde se quiera que vayan los componentes. Este es el diagrama 
de herencia para la clase GridBagLayoutClass. 


El constructor de GridBagLayoutClass se encuentra en la tabla 7.22 y sus 


métodos en la tabla 7.23. 


Tabla 7.22. Constructor de la clase GridBagLayout. 


Constructor 


GrídBagLayout() 


Descripción 


Crea un gestor de grid bag layout. | 


Tabla 7.23. Métodos de la clase GridBagLayout. 


voidaddLayoutComponent(Com- 
ponent comp, Object constraínts) 


voidaddLayoutComponent(String 
nombre, Component comp) 


protected void AdjustForGravity 
(GridBagConstraints constraints, 
Rectangle r) 


protected void ArrangeGrid(cOntainer 


padre) 


GridBagConstraints getconstraints 
(Component comp) 


floatgetL ayoutAlignmentX(Container 
padre) 


floatgetL ayoutAlignmentY (Container 


padre) 
int[][] getL ayoutDimensions() 


protected java.awt. GridBagLayoutin 
to GetLayoutinfo(Container padre, 
int sizeflag) 


Point getL ayoutOrigin() 


Añade el componente dado al esque- 
ma, usando el objeto constraint. 


Añade al esquema el componente 
dado. 


Ajusta las características de grave- 
dad. 


Obtiene la cuadrícula del padre. 


Obtiene los constraints del compo- 
nente dado. 


Se obtiene la alineación a lo largo 
del eje x. 


Se obtiene la alineación a lo largo 
del eje y. 


Determina la anchura de la columna 
y las alturas de la fila para el layout 
grid. 


Obtiene el layout constraints. 


Determina el origen del layoutgrid. | 


ESEJ 


Método Descripción 


double[f! getLayout Weights() Determina los pesos de las filas y 
columnas del layout gríd. 


protected Dimension GetMinsize Obtiene el tamaño mínimo del con- 
(Container padre, java.a wi. GridBag tenedor. 
Layoutinfo info) 


void invalidate Layout(Container Invalida el esquema. 
target) 


void layoutContainer(Containerpadre) Pone el contenedor. 


Point location(int x, int y) Determina qué celda del layout 
contiene un punto. 


protected GridBagConstraints look- Recupera los constraints para un 


upConstraints(Componentcomp) componente dado. 

Dimension maximumLayoutSize Obtiene las dimensiones máximas 

(Container target) del esquema dados los componen- 
tes del contenedor. 

Dimension minimumLayoutSize Determina el tamaño mínimo del 

(Container padre) contenedor, usando este esquema. 

DimensionpreferredLayoputSize Determina el tamaño preferido del 

(Container padre) contenedor, usando el esquema. 

void removeL ayoutComponent Retira del esquema, el componente 

(Component comp) dado. 

void setConstraints(Componentcomp, Establece los constraints para los 

GridBagConstraints constraints) componentesdados en el esquema. 

String toString() Obtiene una representación tipo 


string de este esquema. 


Añadir componentes a un contenedor usando un grid bag layout se hace 
igual que con un grid layout, salvo que se tienen más opciones; por ejemplo, 
se pueden poner las alturas y anchuras relativas de los componentes. La 
inicialización de un grid bag layout es un proceso de dos pasos: primero se 
configura la posición relativa de un componente respecto a los otros, y luego 
se añade el componente al esquema. 

Los componentes se configuran utilizando la clase GridBagConstraints; 
los campos de esa clase aparecen en la tabla 7.24, sus constructores en la 
tabla 7.25 y su método en la tabla 7.26. 


Tabla 7.24. Campos de la clase GridBagConstraints. 


Campo 


Descripción 


int anchor 


static int BOTH 


static int CENTER 


static int EAST 


ipt mN 


int gridheight 


int gridwidth 


int gridx 


int gridy 


static int horizontal 


Insets insets 

int ipadx 

int ipady 

static int NONE 
static int NORTH 


static int NORTHEAST 


static int NORTHWEST 


static int RELATIVE 


Usado cuando el componente es más pequeño 
que su área de visualización. 


Redimensiona el componente horizontal y 
verticalmente. 


Pone el componente en el centro de su área 
de visualización. 


Pone el componente en el lado derecho de su 
área de visualización, centradoverticalmente. 


Este campo se usa cuando el área de visua- 
lización del componente es más grande que 
el tamaño solicitado por él. 


Indica el número de celdas en una columna 
para el área de visualizacióndel componente. 


Indica el número de celdas en una fila para el 
área de visualización del componente. 


Indica la celda a la izquierda del área de vi- 
sualización del componente. 


Indica la celda en la parte superior del área de 
visualización del componente . 


Redimensionael componente, horizontalmen- 
te. 


Indica el padding externo del componente. 

Indica el paddinginterno x del componente. 
Indica el paddinginterno y del componente. 
Indicaque no se redimensione el componente. 


Pone el componente en la parte superior de 
su área visualizable,centrada horizontalmente. 


Pone el componente en la esquina superior 
derecha de su área de visualización. 


Pone el componente en la esquina superior 
derecha de su área de visualización. 


Indica que este componente es el siguiente al 
último componenteen sucolumnao fila, o que 
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static int REMAINDER 


static int SOUTH 


static int SOUTHEAST 


static int SOUTHWEST 


static int VERTICAL 


double weightx 


double weighty 


static int WEST 


Descripción 
este componente está situado a continuación 
del componente previamente añadido. 


Especifica que este componente es el último 
en su columna o fila. 


Pone el componente en el fondo de su área 
visualizable, centrado horizontalmente. 


Pone el componente en la esquina inferior 
izquierda de su área de visualización. 


Pone el componente en la esquina inferior 
izquierda de su área de visualización. 


Redimensiona el componente verticalmente, 
pero no horizontalmente. 


Especifica cómo se distribuye el espacio 
horizontal extra. 


Especifica cómo se distribuye el espacio verti- 
cal extra. 


Pone el componente en el lado izquierda de 
su área de visualización, centrado vertical- 
mente. 


Tabla 7.25. Constructores de la clase GridBagConstraints. 


Constructor 


GridBagConsfraints() 


GridBagConstraints(intgridx, 
int gridy, int gridwidth, int 
gridheight, double weightx, 
double weighty, int anchor, 
int fill, insets, insets, int ¡padx, 
intipady) 


Tabla 7.26. Método de la clase GridBagConstraints. 


Método 


Object clonej) 


Descripción 


Crea un objeto GridBagConstraint. 


Crea un objeto GridBagConstraintscontodos 
los campos inicializados con los valores pa- 
sados. 


Descripción 


Crea una copia de este grid bag constrainf. 


Himm rit en Bolo 3 


Apple sandro 


Figura 7.12. Usar un grid bag layout. 


Veamos un ejemplo de cómo funciona un grid bag layout. Crearemos la 
applet que se muestra en la figura 7.12; aquí, se han puesto tres botones en la 
fila superior del esquema, haciendo que el botón del medio sea el doble que 
los otros, y se añade un cuadro de texto debajo. Cuando el usuario hace clic 
sobre un botón, la applet devuelve el botón que se ha pulsado, como se puede 
ver. 

Se puede especificar las coordenadas x e y para los componentes que se 
añadan a un grid bag layout usando los campos weightx y weighty. Estos 
valores representan los pesos relativos que se quieren dar a los componentes 
en la misma fila o columna. En este caso, se dará a cada componente el 
mismo peso y, pero al segundo botón se le da el doble de peso x que a los otros. 

Comencemos creando un grid bag layout y las restricciones de un objeto: 

import Java.applet.Applet; 


import jJava.awt.*; 
import jJava.awt.event.*; 


public class gridbag extends Applet implements ActionListener 
( 

Button buttonl, button2, button3; 

TextField text1; 


public void inito 

{ 
GridBagLayout gridbag = new GridBagLayouto; 
GridBagConstraints constraints = new ~rid~ag~onstraintso; 
setLayout (gridbag) ; 
constraints.weighty= 1; 
constraints.fill= GridBagConstraints.BOTH; 


Observe que el campofill de constraints del objeto se está inicializando 
con GridBagConstraints.BOTH]o que significa que el gestor de esquemas 
extenderá sus componentes en ambas dimensiones para rellenarlas. A conti- 
nuación, se creará el primer botón y se añadirá al esquema, como sigue: 


public void init () 
( 
GridBagLayout gridbag = new GridBagLayouto; 
GridBagConstraints constraints = new GridBagConstraintso; 
setLayout (gridbag); 
constraints.weighty = 1; 
constraints.fill = GridBagConstraints.BOTH; 


constraints.weigthx = 1; 

buttonl = new Button ("BOtón 1"); 
gridbag.setConstraints (buttonl, constraints); 
buttonl.setActionConmuind ("Botón 1"); 

add (buttonl) ; 

buttonl.addActionListener (this); 


7 
El primer botón tiene un peso x de 1, pero al siguiente botón se le dará un 
peso x de 2, para hacer que sea el doble de ancho que los otros dentro de la 
misma fila: 


public void init () 
I 
Grid~ag~ayoułridbag = new GridBagLayouto; 
GridBagConstraints constraints = new GridBagConstraintsoO; 
setLayout (gridbag); 
constraints.weighty= 1; 
constraints.fill= GridBagConstraints.BOTH; 


constraints.weightx= 1; 

buttonl = new Button ("Botón1"); 
gridbag.setConstraints (button1, constraints); 
buttonl.set-ction-ommand(Botóñ"); 

add (button1); 

buttonl.addActionListener (this); 


conatraints.weightx = 2; 

button2 = new Butt-n (-Botó2"); 
gridbag.setConstraints (button2, constraints); 
button2.setActionCommand ("Botón 2"); 

add (button2) ; 

button2.addActionListener (this); 


constraints.weightx= 1; 

button3 = new -utton ("Botón"); 

constraints.gridwidth= -rid-a--onstraints-REMAINDER; 
gridbag.setConstraintc(button3, constraints); 


textl = new TextFieldo; 

constraints.gridwidth = GridBagConstraints.REMAIN--=; 
gridbag.setConstraintc(text1, constraints); 

addítextl); 


) 


Lo único que queda es gestionar los clics sobre el botón y hacer que se 
visualice el número del botón sobre el que se ha hecho clic: 


public void actionPerformed (ActionEvent e) 
I 
textl.setText ("Hiz0clic en " + 
( (Button) e.getSource ()).getActionCommand~)); 
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Y eso es todo. Ahora este código creará la applet que se muestra en la 
figura 7.12. Este ejemplo se puede encontrar en el fichero gridbag.java en el 
CD. 


Usar intercalados y rellenos 


"Veamos”, dice el programador novato, "¿hay alguna forma de añadir un 
borde alrededor de los componentes del esquema?" "Claro que la hay", le 
responde. "Se pueden usar los intercalados y los rellenos". 

Con los intercalados se puede añadir espacio entre los bordes del contene- 
dor y los componentes. Estos intercalados se crean con la clase Insets, que 
tiene el siguiente constructor: 


insets (int top, int left, int bottom, int right) 


Este es un ejemplo en el que se añaden intercalados de 20 pixels en todos 
los bordes de la applet desarrollada en el apartado anterior: 


public Insets getInsets() 


{ 
return new Insets (20, 20, 20, 20); 


) 


El resultado se muestra en la figura 7.13. Como se puede ver en esta 
figura, hay un espacio de 20 pixels alrededor de los componentes del conte- 
nedor. 

Además se pueden rellenar los componentes individuales. Esto se puede 
hacer con los métodos setHgap y setVgap de los card layout, flow layout y 
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grid layout, así como usando los miembros ipadx e ipady de los grid bag 
layouts. Por ejemplo, se puede modificar la calculadora de multiplicar que se 
escribió anteriormente en este capítulo para añadir un espacio vertical de 10 
pixels entre los componentes, como sigue: 


import Java.applet.Applet; 
import java.awt.*; 
import Java.awt.event.*; 


fir kL 


public class multiplier2 extends Applet implements ActionListener { 


TextField textl, text2, answertext; 
Label multiplylabel; 
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Figura 7.13. Usar intercalados. 


Button buttonl; 
GridLayout g; 


public void inito0 


g = new GridLayout (5, 1); 
g.= setvgap (10) 5 


setLarout ig] i 


textl = new TextField(10); 
add (text1); 


multiplylabel = new Label ("*",Label.CENTER); 
add (multiplylabel); 


text2 = new TextField(10); 
add (text2); 


buttonl = new Button("="); 
add (button1); 


answertext = new TextField(10); 
add (answertext! ; 


) 


public void actionPerformed (ActionEvente) 
{ 
if (e.getSourcef == buttonl)( 
int product = Integer.parselnt (textl.getText0) a 
Integer.parselnt (text2.getTextO); 
answertext.setText (String.value0f (product)); 
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El resultado se muestra en la figura 7.14. 


Figura 7.14. Usar relleno. 


Crear el propio gestor de esquemas 


Uno mismo puede poner los componentes en un contenedor si desinstala 
el gestor de esquemas del contenedor (ver la introducción de este capítulo 
para más detalles). De hecho, podrá incluso crear su propio gestor de esque- 
mas, si se implementa la interfaz LayoutManager2 en una clase (la interfaz 
LayoutMarzager no soporta las restricciones). Estos son los métodos de 
LayoutManager2 que se tendrán que sobrescribir: 


e public void addLayoutComponent (String nombre, Component compo- 
nente): este método añade un componente al esquema. La clase conte- 
nedor le llama, sobrescribe este método si se quieren saber los nombres 
de los componentes del esquema. 


public void removeLayoutCornponent (Componentcomponente): elimi- 
na un componente del esquema. 


public float getLayoutAlignmentX (Container target) and public jloat 
getLayoutAlignmentX (Container target): Especifica cómo alinear los 
componentes en las direcciones x e y, devolviendo un valor de O al 
alinear los componentes en el origen, devolviendo 1 al alinearlo tan 
lejos como se pueda del origen y devolviendo 0.5 al centrar el compo- 
nente. 


public void invalidateLayout (Container target): Invalida un esquema, 
lo que significa que se debería borrar cualquier información oculta si se 
llama a este método. 


public Dimension preferredLayoutSize (Container padre): Devuelve el 
tamaño ideal del contenedor padre. 


public Dimension maximumLayoutSize (Containertarget): Devuelve el 
tamaño máximo del componente. 


public Dimension minimuLayoutSize (Container target): Devuelve el 
tamaño mínimo del componente. 


public void layoutContainer (Container padre): Utiliza los métodos 
resize, move y reshape para gestionar los componentes. 


Mì awT: Listas, 


cuadros de lista, 
áreas de texto, 


barras y cuadros 


de desplazamiento 


Listas 


Este capítulo trata un número importante de componentes AWT: listas, 
cuadros de lista desplegables, cuadros de texto, barras de desplazamiento y 
cuadros de desplazamiento. Estos componentes son fundamentales para la 
programación AWT, resultan familiares para casi todos los usuarios GUI, y 
los veremos rápidamente en esta sección. Observe que uno de los temas 
principales de este capítulo es el desplazamiento; todos los controles de este 
capítulo lo soportan de una u otra forma, permitiendo al usuario moverse, 
fácilmente, por grandes documentos. 


Como su nombre indica, un control de tipo lista presenta al usuario una 
lista de elementos, cadenas de texto, en la que puede hacer una selección. En 
los entornos de trabajo con ventanas, con frecuencia, el espacio es un premio, 
por lo que es una buena idea colocar elementos en listas, ya que usando las 
barras de desplazamiento, se pueden tener listas largas en componentes de 
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lista cortos. El usuario puede seleccionar el elemento de la lista que quiera e ' 
iniciar alguna acción, haciendo doble clic sobre él. Además, las listas pueden 
soportar la selección múltiple, usando las teclas Mayús y Control. Sin embar- 
go, si se soporta la selección múltiple, hay que pensar en cómo utilizar el 
ratón dentro de una lista; porque al hacer clic sobre un elemento se selecciona 
y luego, con el doble clic, se inicia algún tipo de acción. Al hacer doble clic 
sobre un elemento, el resto se deselecciona. Para resolver este problema, Sun 
sugiere el uso de algún otro evento, como puede ser hacer clic sobre un botón, 
para iniciar una acción cuando se trata de selecciones múltiples. 


Cuadros de lista desplegables 


Los cuadros de lista desplegables presentan al usuario una lista de elemen- - 
tos para seleccionar, pero hay una diferencia, son más compactos que las 
listas. Los cuadros de lista desplegables se parecen a los cuadros de texto, 
aunque no se pueden editar, con un pequeño botón a la derecha que tiene una 
flecha apuntando hacia abajo. Cuando el usuario hace clic sobre la flecha, se 
abre una lista que contiene todas las selecciones disponibles, y el usuario 
puede seleccionar una de ellas. Una vez hecha la selección, se cierra la lista y 
se visualiza la selección actual. Si el usuario abre otra vez la lista, la selec- 
ción actual aparece resaltada. Observe que estos cuadros sólo están diseñados 
para visualizar al mismo tiempo una única selección, lo que significa que no 
se puede seleccionar a la vez más de un elemento. Usando las teclas Mayús o 
Control y haciendo clic al mismo tiempo se obtiene el mismo efecto que si se 
hace clic en un elemento. 

Como el resto de componentes de este capítulo, los cuadros de listas 
desplegables soportan el desplazamiento. Si la lista de elementos es larga, las 
barras de desplazamiento aparecerán al lado de la lista automáticamente. 


Áreas de texto 


Las áreas de texto son como los cuadros de texto, salvo que soportan texto- 
en dos dimensiones, con filas y columnas, por lo que se puede visualizar más 
texto. En el momento de crear el área de texto, hay que indicar su tamañid. EM 
filas y columnas (medido en caracteres). El resultado es un cuadro de 18X10 
que tiene el número de filas y columnas que se haya especificado. Cuando se 
quiere trabajar con documentos enteros, en vez de con líneas de texto, se usan 
las áreas de texto. 


Al igual que el resto de los componentes de este capítulo, las áreas de 
texto soportan el desplazamiento. Se puede especificar si se quiere una barra 
de desplazamiento horizontal, vertical, ambas o ninguna. Si no se tiene una 
barra de desplazamiento horizontal (y sólo si no tiene una barra de desplaza- 
miento horizontal), la opción de ajuste de palabras se habilita automáticamente. 


Barras de desplazamiento 


Las barras de desplazamiento son, por supuesto, los elementos de despla- 
zamiento más importantes, y todos los usuarios de interfaces gráficas cono- 
cen su existencia y su funcionamiento. Los usuarios utilizan el ratón para 
manipular el indicador (también denominado cuadro de desplazamiento, ele- 
vador o burbuja) de la barra de desplazamiento seleccionado un valor dentro 
de un intervalo continuo. Este intervalo se establece al crear la barra de 
desplazamiento y, cuando el usuario selecciona un valor diferente, podemos 
capturar los eventos generados por la barra de desplazamiento para leer este 
nuevo valor. El usuario también puede hacer clic sobre los dos botones de 
flecha que hay en los extremos de la barra de desplazamiento para aumentar o 
disminuir el valor en cantidades fijas que habremos establecido previamente. 
Por último, el usuario puede hacer clic sobre el recorrido de la propia barra de 
desplazamiento (es decir, la zona comprendida entre el cuadro de desplaza- 
miento y los botones de desplazamiento) para aumentar o disminuir el valor 
en cantidades fijas (normalmente mayores que las anteriores) que también 
habremos establecido previamente. 


Paneles de desplazamiento 


Es posible que se quieran utilizar las barras de desplazamiento para mo- 
verse en otros componentes, como puede ser un cuadro de texto largo; los 
controles de Java las soportan pero no del todo. Para hacer que el desplaza- 
miento en otros componentes sea más fácil, Java tiene la clase ScrollPane. Se 
usan las áreas de desplazamiento para añadirles componentes y permitir que 
el área de desplazamiento los gestione. Una vez quese haya añadido un gran 
componente a un área de desplazamiento, de una vez, sólo será visible una 
parte de él, y se podrán usar las barras de desplazamiento del área para ir a 
otras partes de ese componente. Eso es todo. Ahora que ya hemos revisado el 
contenido de este capítulo, es el momento de pasar a la siguiente sección. 


Usar las áreas de texto 
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"Uh-oh", dice el programador novato, "tengo un problema. He escrito mi4 
novela en un cuadro de texto de Java, y..." Usted sonríe y le dice, "¿Y se ha 
quedado sin espacio?" "Claro", dice el programador novato, "no es muy 
conveniente escribir una novela entera como si fuera una línea de texto". 
"Pruebe las áreas de texto", le sugiere. 

Un área de texto es un cuadro de texto de dos dimensiones; de hecho': 
tienen una gran ventaja, se pueden visualizar todos los documentos en áreas 
de texto, incluyendo el tratamiento de las palabras al final de las líneas. 
Además se pueden usar las barras de desplazamiento para moverse por el 
texto. Observe, sin embargo, que si ha habilitado una barra de desplazamien- 
to horizontal, este tratamiento de las palabras al final de la línea quedará 
deshabilitado. Este es el diagrama de herencia de la clase AWT TextArea: 
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Verá los campos de la clase TextArea, que se usan en los constructores de 
la clase TextArea, en la tabla 8.1, sus constructores en la tabla 8.2 y sus 
métodos en la 8.3. 7 

Veamos un ejemplo. En este caso, se creará un área de texto de 10 filas y 
20 columnas (observe que estas dimensiones se miden en caracteres). Ade= 
más se añadirá un botón sobre el que el usuario puede hacer clic para visualizar 
el texto "¡Hola desde Java!" en el área de texto. 


Tabla 8.1. Campos de la clase TextArea. 


Campo Descripción 


static int SCROLLBARS-BOTH Añade las barras de desplazamiento 
horizontal y vertical. 

static int SCROLLBARS-HORI- Añade, únicamente, una barra de 

ZONTALONLY desplazamiento horizontal. 

static int SCROLLBARS- NONE Indica que no se creará ninguna 
barra de desplazamiento en el área 
de texto. 

static int SCROLLBARSVERTICAL Sólo visualiza una barra de despla- 

ONLY zamiento vertical. 


Tabla 8.2. Constructores de la clase TextArea. 


Constructor 


TextArea() 


TextArea(int filas, intcolumnas) 


TextArea(String texto) 


TextArea(String texto, intfilas, 
intcolumnas) 


TextArea(String texto, intfilas, int 
columnas, intbarras-de-desplaza- 
miento) 


Descripción 


Construye una nueva área de texto. 


Construye una nueva área de texto, 
vacía, con el número de filas y 
columnas indicado. 


Construye una nueva área de texto 
con el texto dado. 


Construye una nueva área de texto, 
con el texto dado ycon el número de 
filas y de columnas dado. 


Construye una nueva área de texto 
con el texto dato y fija la visibilidad 
de las filas, columnas y barras de 
desplazamiento. 


Tabla 8.3. Métodos de la clase TextArea. 


Método 


void addNotify() 
void appendText(String str) 


void appendText(String str) 


intgetColumns() 


Dimension getMinimumSize(1 


Dimension getMinimumsSize(intfilas, 
intcolumnas) 


DimensiongetPreferredSize() 


Dimension getPreferredSize(intfilas, 
intcolumnas) 


Descripción 


Crea el compañero del área de texto. 


Añade texto al texto actual del área 
de texto. 


Obsoleto. Reemplazado por 
append(String1. 


Obtiene el número de columnas del 
área de texto. 


Estableceeltamaño mínimo del área 
de texto. 


Fija el tamaño mínimo del área de 
texto con el número de filas y de 
columnas dado. 


Establece el tamaño preferido del 
área de texto. 


Establece el tamaño preferido de un 
área de texto con el número de filas 
y de columnas indicado. 
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Método Descripción 


int getRows() Obtiene el número de filas del área 
de texto. 
intgetScrollbarVisibility () Obtiene un valor enumerado que 


indica la visibilidad de la barra de 
desplazamiento. 


void insert(String str, intpos) Inserta el texto dado en la posición | 
del área de texto indicada. 


void insertText(Sring str, int pos) Obsoleto. Reemplazado por insert- 
(String, int). 

Dimension minimumSize() Obsoleto. Reemplazado porgetMini- 
mumsSize(). 

Dimension minimumsSize(intfilas, Obsoleto. Reemplazado porgetMini- 

intcolumnas) mumsSize(int, int). 

protected String paramString() Devuelve una representación en 
cadena del estado del área de texto. 

Dimension preferredSize() Obsoleto. Reemplazado porgetpre- 
ferredSize(). 

Dimension preferredSize(intfilas, Obsoleto. Reemplazado porgetpre- 

intcolumnas) ferredSize(int, int). 

void replaceRange(String str, intinicio, Cambia eltexto entre las posiciones 

intfinal) de inicio y final. 

void replace Text(String str, intinicio, Obsoleto. Reemplazado porreplace- 

intfinal) Range(String, int, int). 

void setColumns(int columnas) Fija el número de columnas. 

void setRows(int filas) Fija el número de filas. 


Hay varias formas de situar texto en un área de texto. Por ejemplo, se 
puede usar el método insert para poner texto en una posición específica 
(comenzando en 0) de la cadena que el área de texto gestiona, o se puede usar 
el métodoappend para añadir texto a continuación del actual. Asíes cómo se 
usa el método insert: 


import java.applet.Applet; 
import java.awt.*; 
import java.awt.event.*; 


public class areadetexto extends Applet implements ActionListener ( 


TextArea textareal; 
Button buttonl; 
public void init () 
I 
textareal = new TextArea("", 10, 20, TextArea.SCROLLBARS-BOTH) ; 
add (textareal) ; 
buttonl = new Button (" ¡Haga clic aquí!"); 
add (buttonl1); 
buttonl.addActionListener (this); 


} 


public void actionperformed (ActionEvente) 


{ 


String msg = "¡Hola desde Java!" ; 
if(e.getsource() == buttonl)( 
textareal.insert (msg, 0); 


1 
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Además, observe que se han añadido al área de texto barras de desplaza- 
miento horizontal y vertical. El resultado aparece en la figura 8.1. Con las 
áreas de texto se pueden hacer más cosas, por ejemplo, se puede seleccionar y 
reemplazar texto. Ver el siguiente apartado para más detalles. 


Reemplazar texto en áreas de texto 


El especialista en soporte de productos (ESP) no está contento, como es 
usual, y le dice, "Los usuarios se están quejando del nuevo procesador de 
textos que ha escrito en Java". '"¿Sí?'"pregunta. "Quieren que sea posible 
seleccionar y reemplazar texto", dice ESP. "Algunas personas", dice, "nunca 
están satisfechas". Se puede usar el método replaceRange para reemplazar un 
rango de texto en un área de texto: 


void replaceRangeíStringstr, int start, int end); 


Donde, stres la cadena con la que se quiere reemplazar el texto antiguo, 
start es el comienzo del rango de caracteres a reemplazar y end es el final del 
rango. 
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Figura 8.1. Usar un área de texto. 


Este es un ejemplo en el que se visualiza el texto "Ya es la hora." en un 
área de texto. El usuario puede seleccionar parte o todo de ese texto y hacer 
clic sobre un botón para reemplazar el texto seleccionado con el mensaje 


"iHola desde Java!". Empezamos creando la nueva área de texto e 
inicializándola con el texto "Ya es la hora.": 


import Java.applet.Applet; 
import java.awt.*:; 
import java.awt.event.*; 


public class reemplazar extends Applet implements ActionListener 
{ 
TextArea textareal; 
Button buttonl; 
public void init () 
{ 
textareal = new TextArea ("Ya es la hora.", 5, 20. 
TextAreas. POROLLAARS BOTH 
add (textareal); 
buttonl = new Button ("-ambiael texto seleccionado"); 
addíbuttonl); 
buttonl.addAction-istener (this); 


Cuando el usuario hace clic sobre el botón, se puede determinar el texto 
seleccionado utilizando los métodos getSelectionStart y getSelectionEnd y 
luegoreemplazar el texto seleccionado con "¡Hola desde Java!"”, como sigue: 


public void actionPerformed (ActionEvent e) ( 
if(e.getSource0 == buttonl) ( 
textareal.replaceRange ("iHola desde Java!" 
textareal.getSelectionStart-), 
textareal .getSelectionEnd0) 5 


) 


El resultado se muestra en la figura 8.2, y encontrará este ejemplo en el 
CD como reemplazar-java. Además de reemplazar el texto, se puede buscar. 
Ver el siguiente apartado. 
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Figura 8.2. Reemplazar el texto seleccionado en un área de texto. 


Buscar y seleccionar texto en áreas de texto 


El especialista en soporte de productos regresa descontento de nuevo. 
"Ahora, los usuarios quieren poder buscar texto cuando usan su procesador 
de textos", informa. "¿Qué hacemos?", le pregunta, exasperado. "¿Verificar 
letra por letra?". La clase TextArea no soporta ningún método directo para 
buscar texto pero la clase String sí. Por lo tanto, se puede copiar el texto de un 
área de texto en un objeto String y buscar ese objeto en el texto que se quiera, 
usando el método indexOf. Este es un ejemplo en el que se permite al usuario 
hacer clic sobre un botón para buscar y seleccionar la palabra hora en el texto 
"Yaes la hora." de un área de texto. Empezaremos creando una nueva área de 
texto, y luego lo inicializaremos con el texto "Ya es la hora.": 
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import java.applet.Applet; 
import Java.awt.*; 
import java.awt.event.*; 
/* 
<APPLET 
CODE=buscar.class 
WIDTH=200 
HEIGHT=200 > 
</APPLET> 
* 
/ 
public class buscar extends Applet implements -ction-istener 


I 


TextArea textareal; 
Button buttonl; 
public void init () 
t textareal = new TextArea("Y8 es la hora.", 5, 20, 
TextArea . SCROLLBARS-BOTH) ; 
add (textareal); 
buttonl = new Button("Buscar X"horaX"") ; 
add (buttonl) ; 
buttonl.add-ctionListener (this) 


Ahora, cuando el usuario hace clic sobre el botón, el texto del área se 
carga en una cadena llamada S: 


public void actionperformed (ActionEvent e) ( 
if(e.getSource() == buttonl) ( 
String s = textareal .getTextO0; 


Ahora, se puede buscar el texto "hora" usando el método indexOf de la 
clase String: 


public void actionperformed (ActionEvent e) 1 
if(e.getSource0 == button1)l 

String s = textareal.getTextO0; 

String s2 = new String("hora"); 


int location = s.indexo0f (s2); 


Una vez que se haya encontrado la cadena "hora", se usará el método 
TextAreaselect (heredado de la clase AWT TextComponent) para resaltar el 
texto. Asíes como se usa select en general: 


void select (int selectionstart, int selectionEnd); 


Así es como usaríamos el método select en el código: 


public void actionperformed (ActionEvente) ( 
if (e.getSourceO == buttonl)( 
String s = textareal.getTextO0; 
String s2 = new String("horaW); 
int location = s.indexo0f (s2); 
textareal.select (location, location + s2.lengthoO) 5 


El resultado de este código aparece en la figura 8.3. Cuando el usuario 
hace clic sobre el botón, el código busca y resalta el texto "hora" en el área de 
texto. Este ejemplo se llama buscar.java en el CD. 


E applel Viewer: bur PE 


Applet started 
Figura 8.3. Buscar y seleccionar texto en un área de texto. 


Usar listas 


El especialista de soporte de productos regresa y dice, "Hay un problema". 
"¿Sí?" Je pregunta. "Es sobre su último programa de catálogo de CD de 
música clásica, hay más de cien mil listas". "Correcto", le dice prudentemen- 
te. "Por supuesto, la lista es más larga que la pantalla”. "Aproximadamente 


dos mil pies de larga", le dice ESP. 
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Si se tiene una lista larga de elementos para presentar, hay que pensar e? 
utilizar un control de tipo lista. Se puede rellenar una lista con muchos 
elementos de texto, usando el método add de la clase List y presentar al 
usuario sólo unos pocos al mismo tiempo (se puede seleccionar cuántos). El 
usuario puede resaltar un elemento de la lista haciendo clic sobre él y puede 
hacer doble clic para iniciar alguna acción. De hecho, el usuario puede selec- 
cionar múltiples elementos de una lista e iniciar alguna acción, normalmente 
haciendo clic sobre un botón. Este es el diagrama de herencia de la clase List: 


Los constructores de la clase List se encuentran en la tabla 8.4 y su? 
métodos en la tabla 8.5. Hay que prestar especial atención a la tabla de 
métodos; muchos de ellos son útiles, como getltemcount, que devuelve el 
número de elementos de la lista. 


Tabla 8.4. Constructores de la clase List. 


Constructor Descripción 

Listo Crea un nuevo cuadro de despla- 
zamiento. 

List(int filas) Crea un nuevo cuadro de desplaza- 


miento, con el número de líneas vi- 
sibles que se indica. 


List (int filas, boolean multipleMode) Crea una nueva lista con el número 
de filas especificado y se habilita la 
selección múltiple, si multipleMode 
es verdadero. 


void add(Stringelemento0) Añade el elemento dado al final de 
la lista. 


void add(String elemento, intíndice) Añade el elemento dado a la liSta en 
la posición marcada por el índice. 


voidaddActionListener(ActionListe- Añade el action listenerdado pala 


ner ) obtener los eventos de acción de la 
lista. 

void addltem(String elemento) Obsoleto. Reemplazado por add 
(String). 


Conatructor 


void addltem(String elemento, int 
índice) 


void addltemListener(itemListener 1) 


void addNotify() 
boolean allowsMultipleSelections() 


void clear() 
int countltems() 
void delltem(int position) 


void delltem(int start, int end) 


void deselect(intíndice) 
String getltem(intíndice) 
int getltemCount() 


String[] getltemso 


Dimension getMinimumSize() 


Dimension getMinimumSize(intfilas) 


Dimension getPreferredSize() 


Dimension getPreferredSize(int filas) 


int getRows() 


Descripción 


Obsoleto. Reemplazado por add 
(String, int). 


Añade el ¡tem listener dado para 
obtener eventos de elemento de la 
lista. 


Crea el compañero de la lista. 


Obsoleto. Reemplazado poris Multi- 
pleMode(). 


Obsoleto. Reemplazado por remo- 
veA//(). 


Obsoleto. Reemplazadopor getltem- 
Count(). 


Obsoleto. Reemplazadopor remove 
(String) y remove(int). 


Obsoleto. No es de uso público. 


Deselecciona el elemento asociado 
al índice dado. 


Obtiene el elemento asociado al 
índice dado. 


Obtiene el número de elementos de 
la lista. 


Obtiene los elementos de la lista. 


Determina el tamaño mínimo de la 
lista. 


Obtiene las dimensiones mínimas 
de la pantalla para una lista con el 
número de filas dado. 


Obtiene eltamaño preferido de esta 
lista. 


Obtiene las dimensiones preferidas 
para una lista con el número de filas 
dado. 


Obtiene el número de líneas visibles 
de la lista. 
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Constructor 


int getSelectedIndex() 

int[] getSelectedIndexes() 
String getSelectedltern() 
String[] getSelectedltems() 


Object![]getSelectedObjects() 


intget Visiblelndex() 


boolean isIndexSelected(intíndice) 
boolean ¡sMultipleMode() 
boolean isSelected(intíndice) 


void rnakeVisible(intíndice) 


Dirnension rninimurnSize() 
Dimension rninimurnSize(intfilas) 
protected String pararnStringO 
Dirnension preferredSize() 
Dimension preferredSize(intf ilas) 


protected void processActionEvent 
(ActionEvent e) 


Descripción 


Obtiene el índice del elemento se- 
leccionado en la lista. 


Obtiene los índices seleccionados 
de la lista. 


Obtiene el elemento seleccionado 
de esta lista. 


Obtiene los elementos seleccio- 
nados de esta lista. 


Obtiene los elementos seleccio- 
nados de la lista en un array de 
objetos. 


Obtiene el Índice del último elemento 
que se hizo visible con el método 
makeVisible. 


Determina si el elemento dadode la 
lista está seleccionado. 


Determina si la lista permite hacer 
selecciones múltiples. 


Obsoleto. Reemplazado poris Index- 
Selected(int). 


“ aceque el elemento del índice 
dado sea visible al principio de la 
lista. 


Obsoleto. ReemplazadoporgetMini- 
murnSize(). 


Obsoleto. Reemplazadopor getMini- 
murnSize(). 


Obtiene el string que representa el 
estado de esta lista. 


Obsoleto. Reemplazado por getPre- 
ferredSize(). 


Obsoleto. Reemplazadopor getpre- 
ferredsize(int). 


Procesa los eventos de acción que 
ocurrenen estecomponenteenvián- 


Descripción 


Constructor 


protected void processEvent 
(AWTEvente) 


protected void processltem Event 
(ltemEvent e) 


void remove(intposición) 
void remove(String elemento) 


void removeActionListener(Action- 
Listener 1) 


void removeAll() 


void removeltemListener(ltemListe- 
ner 1) 


void removeNotity() 

void replaceltem(Stringvalor-nuevo, 
intíndice) 

void select(intíndice) 


void setMultipleMode(boolean b) 


void setMultipleSelections(boolean b) 


dolos a los objetos ActionListener 
registrados. 


Procesa los eventos de esta lista. 


Procesa eventos de elemento que 
se produzcanen la lista enviándolos 
alos objetos ltembListener registra- 
dos. 


Elimina el elemento de la lista que 
está en la posición dada. 


Elimina la primera ocurrencia de un 
elemento de la lista. 


Elimina el actionlistenerdado, para 
que no reciba más eventos de acción 
de la lista. 


Elimina todos los elementos de la 
lista. 


Elimina el ¡tem listenerdado para 
que no reciba más eventos de ele- 
mento de la lista 


Elimina el compañero de la lista. 


Reemplaza el elemento de la lista 
que ocupa el índice dado con la 
nueva cadena. 


Selecciona el elemento de la lista 
que ocupa el índice dado. 


Establece el indicadorque determina 
si la lista permite selección múltiple. 


Obsoleto. Reemplazado porsetMul- 


tipleMode(boo 1ean). | 


Veamos un ejemplo. En este caso, se añadirán elementos a una lista, 
haciendo que sólo cuatro de ellos se vean de una vez. Cuando el usuario haga 
doble clic sobre uno de ellos, se notificará en un cuadro de texto que uno de 


y ; £ T 
ellos se ha seleccionado. Empezaremos creando la lista y después haremos 
que sólo cuatro líneas sean visibles, como sigue: 


import Java.applet.Applet; 
import java.awt.*; 
import jJava.awt.event.*; 


public class lista extends Applet implements ActionListener { 


List listl; 
TextField textl: 


public void init ()( 
textl = new TextField(20); 
add (text1); 


listl = new List (4); 


Ahora, se añaden nueve elementos usando el método add: 


public void init ()( 
textl = new TextField(20); 
add (text1); 


listl = new List (4); 
listl.add("Elemento 1 
listl.add("Elemento 2 
listl.add("Elemento 3 
listl.add("ElementO 4 
listl.add("ElementO 5" 
6 
g 
8 
9 


); 
listl.add("ElementO ”); 
li-tl1.add(-Element(G"); 
listl.add("Elemento 8"); 
listl.add ('Elemento ")5 


add (listl); 


Después de añadir la lista a este esquema, se le añade un listener. Esto 
significa que las listas utilizan las interfaces ActionLisrener, al igual que los 
botones. Asíes como añadimos esto al código: 


public void init ()( 
textl = new TextField(20); 
addítextl) ; 


listl = new List (4); 
listl.add("ElementO 1"); 
listl.add("ElementO0 2"); 
listl.add("Elemento 3”); 
listl.add("ElementO 4"); 
listl.add("Elemento 5"); 
listl.add("Elemento 6") 
listl.add("Element-7"); 
listl.add("Elemento 8") 
listl.add("Elemento 9"); 
add (list1); 


listl.addActionLliatanar (cla) 


Ahora necesitamos añadir un método actionPerformed al main de la clase 
applet para gestionar los dobles clic (a este método no se le llama con clic 
simples, que es cuando se seleccionan los elementos en una lista): 


public void actionPerformed (ActionEvent e) 


{ 


En este caso, se obtendrá el elemento sobre el que el usuario ha hecho 
doble clic usando el método getSelectedlrem de la clase List (el primer clic 
del doble clic selecciona el elemento) y luego se visualiza ese elemento en el 
cuadro de texto, como sigue: 


public void actionPerformed (ActionEvent e) 


{ 


if(e.getSource() == listl)( 
textl.set-ext (((“-iste)getSo-rce()).“v-et-electedItem-) 
1 
1 


El resultado de este código se muestra en la figura 8.4. Cuando el usuario 
hace doble clic en un elemento de la lista, ese elemento se visualiza en el 
cuadro de texto. Observe además que sólo cuatro elementos de los nueve que 
hay en total, son visibles en la lista, porque la lista actual es más larga que el 
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número de elementos visibles. El control lista ha añadido automáticamente 
una barra de desplazamiento vertical. Este ejemplo se llama lista.java en el 
CD. 

Se pueden hacer más cosas con las listas, por ejemplo, se puede permitir al 
usuario que haga selecciones múltiples. Echaremos un vistazo a esto en el 
siguiente punto. 


a Appii Wiewer haa RARE 
npa 


| Elemento 7 


jomenn } 
lnerdo d 


Apolel cano: 


Figura 8.4. Usar una lista. 


Usar listas de selección múltiple 


"Uh-oh", dice el programador novato", tengo un problema". Mi nuevo 
programa permite a los usuarios ordenar los alimentos utilizando una lista, 
pero lo tienen que hacer uno por uno". "No es problema", le contesta, "basta 
con habilitar la selección múltiple en la lista". 

Si al constructor de la clase List se le pasa un segundo parámetro con elw 
valor verdadero, se creará una lista que soporta la selección múltiple. El 
usuario puede seleccionar múltiples elementos pulsando la tecla Control y a 
la vez haciendo clic o seleccionar un rango de elementos pulsando la tecla 
Mayús y haciendo clic. 

Veamos un ejemplo. En este caso, permitiremos al usuario seleccionar- 
varios elementos y cuando haga clic sobre un botón, listaremos los elementos 
seleccionados en un cuadro de texto. Empezaremos creando una lista de 
selección múltiple: 

import java.applet.Applet; 

import java.awt.*; 


import java.awt.event.*; 


'"publicclass seleccionmult extends Applet implements ActionListener ( 


List listl; 
“extFieldtextl; 
Button buttonl; 
String selections|[!; 


public void initoOl 
textl = new TextField(40); 
add (text1) 3 
listl = new List (4, true); 
listl.add("ElementO0 1"); 
listl.add("Elemento 2"); 
li-t1l.add(-Elemento3"); 
li-tl.add(-ElementaA"); 
listl.add("Elemento 5"); 
listl.add("Elemento 6"); 
listl.add("Elemento 7"); 
listl.add("Elemento 8"); 
li-t1l.add(-Elemento9"”"); 
add (list1); 
buttonl = new Button("Mostrar las selecciones"); 
buttonl.addActionListener (thic); 
add (buttonl1); 

> 


A continuación, se añade un ActionListener ala lista y el botón sobre el que 
el usuario puede hacer clic para visualizar las selecciones hechas en la lista: 
public void init ()( 


textl = new TextField(40); 
add (text1); 


listl , true); 
listl to"); 
listl to2"); 
listl to3"); 
listl to4"); 
listl to). 
listl to6"); 
listl to7");5 
listl tog"); 
listl ] to9"); 
add (list1) ; 


buttonl = new Butt-n(“-Mostrakas selecciones"); 
buttonl.addActionListener (this); 
add (buttonl) ; 
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Ahora, es necesario usar un botón para mostrar las selecciones múltiples 
que se han hecho (observe que no se permite al usuario iniciar una acción que 
involucre selecciones múltiples utilizando el ratón, porque el hacer clic o 
doble clic sobre cualquier elemento deseleccionará el resto). 

Cuando el usuario hace clic sobre el botón, se usa el método 
getSelectedltems del componente List para obtener un array de tipo String de 
los elementos seleccionados: 

String selections[!'; 

public void actionPerformed(ActionEvent e) 


{ 
if(e.getSource0 == button1)I 


selections = listl.getSelectedItems0; 


A continuación, se recorre ese array, añadiendo todos los elementos a una-' 
cadena que comienza con "Usted seleccionó: ": 


public void actionperformed (ActionEvent e) 


I 


String outstrinq = new String ("Usted seleccionó:"); 


if (e.getSource() == buttonl){ 
selections = listl.getSelectedItems0; 
for(int loopIndex = 0; loopIndex < selections.length; 


loopIndex++)( 


outstring += + selections[loopIndexl; 


Finalmente, se sitúa la cadena con todas las selecciones en el cuadro de 
texto: 


public void actionPerformed (ActionEvent e) 


( 


String outstrinq = new String ("Usted seleccionó:”); 


if(e.getSource0 == buttonl)( 
selections = listl.qetSelectediterns0; 
for(int loopIndex = 0; loopIndex < seiections.length; 
loopIndex++){ 
outstring += " " + selections[loogIndexl; 


taxti. astet (cutátrisgh; 


Y eso es todo. El resultado aparece en la figura 8.5. Como se puede ver en 
esta figura, el usuario puede hacer selecciones múltiples en esta nueva lista, y 
cuando haga clic sobre el botón, las selecciones aparecerán en el cuadro de 
texto. Este ejemplo se llama seleccionmult.java en el CD. 


Elton Yese rebre corel chaia 


| | Usted selecciono Elemento 2 Elemento 4 
CEEE] 


Figura 8.5. Usar la selección múltiple en una lista. 


Usar cuadros de lista desplegables 


"Vaya", dice el programador novato, "el gran jefe está recortando costes 
de nuevo, y dice que todos los controles deben tener la mitad de su tamaño 
original. ¡Pero el control lista que estoy utilizando es ya bastante pequeño!" 
"No hay problema", le dice, "basta con usar un cuadro de lista desplegable, 
en su lugar". 

Los cuadros de lista desplegables son como las listas que sólo visualizan 
un elemento. Para visualizar toda la lista en un cuadro de este tipo, se hace 
clic sobre el botón que se muestra en la parte derecha del control. Este hace 
que se muestre una lista desplegable y que luego se pueda seleccionar un 
elemento con el ratón. Después, la lista se cierra. La selección actual aparece 
en el cuadro de lista desplegable cuando se cierra la lista (observe que no se 
puede hacer selección múltiple en este tipo de cuadros). Este es el diagrama 
de herencia de los cuadros de lista desplegables: 
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El constructor de la clase Choice se encuentra en la tabla 8.6 y sus méto- 
dos en la tabla 8.7. 


Tabla 8.6. Constructor de la clase Choice. 


Constructor Descripción 


Choicef) Crea un nuevo cuadro de lista des- 
plegable. 


Tabla 8.7. Métodos de la clase Choice. 


Descripción 
void add(Stringelement0) Añade un elemento a este control. 
void addltem(String elemento) Añade un elemento a este control. 


void addltemListener(ttemListener Y) Añade el item listener dado para 
obtener los eventos de este control. 


void addNotify () Crear el compañero de este control. 

int countltems() Obsoleto. Reemplazado porgetltem- 
Count(.. 

String getltem(int Índice) Obtiene la cadena de este control 


que ocupa el índice dado. 


intgetltemCount() Obtiene el número de elementos de 
este control. 


intgetSelectedindex() Obtiene el índice del elemento 
seleccionado actualmente. 


String getSelectedltem() Obtiene una representación de tipo 
string de la selección actual. 


Object[] getSelectedObjects() Obtiene un array (longitud 1) que 
contiene el elemento seleccionado 
actualmente. 


void insert(Stringelemento, int índice) Inserta el elemento en la posición 


dada. 
protected String paramString() Obtiene la representacióntipo string 
del estado de este control. 
protected voidprocessEvent Procesa los eventos en este control. 
(AWTEvent e) 
protected voidprocessltemEvent Procesa los eventos de elemento 


(ItemEvent e) que ocurren en este control, envián- 


Método z Descripción 
dolos a cualquiera de los objetos 


ItemListenerregistrados. 


void remove(int posición) Elimina el elemento que está en la 
posición indicada. 

void remove(Stringelemento) Elimina la primera ocurrencia de un 
elemento de este control. 

void removeAll() Elimina todos los elementos del 
control. 


void removeltemListener(ltemListe- Elimina unitem listenerpara que no 
ner 1) obtenga más eventos de elemento 
de este control. 


void select(int pos) Fija el elemento seleccionado de 
este control a la posición indicada. 


void select(String str) Fija el elemento seleccionado de 
este control al elemento que tiene el 
mismo nombre que la cadena dada. 


Veamos un ejemplo. En este caso, se añadirá un cuadro de lista desplega- 
ble a un programa y se usará el método add para añadir los elementos a su 
lista interna. Cuando el usuario haga una selección, se visualizará esa nueva 
selección en un cuadro de texto. 

Empezaremos creando una nueva lista desplegable y su lista interna (ob- 
serve que no se tienen muchas opciones para crear este tipo de controles, sólo 
hay un constructor, y no tiene parámetros): 


import java.applet.Applet; 


import java.awt.*; 
import java.awt.event.*; 


public class choice extends Applet implernentc ItemListener ( 


TextField textl; 
Choice choicel; 


public void init ()( 


textl = new TextField(20); 
add (text1l); 


choicel = new Choice (); 

choicel.add ("Elemento 1"); 

choicel.add ("Elemento 2"); 
choicel. add ("ElelftentO 3") 5 
choicel. add ("Elemento 4")5 
choicel. add ("Elemento 5") 
choicel.add ("Elemento 6"); 
choicel.add("ElementO0 7"); 
choicel .add ("Elemento8"):5 
choicel.add ("Elemento 9"); 
choicel.add ("Elemento 10"); 
choicel.add("Element0 11"); 
choicel.add ("Elemento 12"); 

1 


Con un gran número de elementos como ocurre aquí, el cuadro de lista 
desplegable añadirá automáticamente una barra de desplazamiento vertical. 

Ahora, gestionaremos los eventos del cuadro de lista desplegable. Con 
este tipo de controles, usaremos las interfaces lItemListener, no las 
ActionListener como se hace con los controles de tipo lista. La interfaz 
ItemListener sólo tiene un método, itemStateChanged: 


void itemStateChanged (1temEvent e) 


A este método se le pasa un objeto de la clase ItemEvent. Los campos de7 
esta clase se muestran en la tabla 8.8, su constructor en la tabla 8.9 y sus 
métodos en la 8.10. 


Tabla 8.8. Campos de la clase ltemEvent. 


Campo Descripción 


static int DESELECTED Indica que un elemento seleccionado | 
ha sido deseleccionado. 

static int ITEM-FIRST E primer número del rango de ID'S 
usado para los eventos de elemento. 

static int ITEM-LAST E último número del rango de ID's 
usado para los eventos de elemento. 

static int ITEM-STATE-CHANGED  Indicaqueel estado de un elemento 
cambió. 

static int SELECTED Indica que un elemento estaba se- 
leccionado. 


Tabla 8.9. Constructor de la clase ltemEvent. 


Constructor Descripción 


ltemEvent(ltemSelectable source, int Construye un objeto ltemEvent. 
id, Object item, int statechange) 


Tabla 8.10. Métodos de la clase ltemEvent. 


Método Descripción 


Object getltem() Obtiene el elemento afectado por el 
evento. 


ltemSelectable getltemSelectable() Obtiene el que origina el evento. 


intgetStateChange0 Obtiene el tipo de cambio de estado 
(esdecir,seleccionado o deseleccio- 
nado). 

String paramStringO Obtiene una cadena que identifica 


este evento. 


A continuación se añade un ftemListener al cuadro de lista desplegable, 
como sigue: 


public void init () 

{ 
textl = new TextField(20); 
add (text1); 


choicel = new Choice (); 
choicel.add ("Elemento 1"); 
choicel.add ("Elemento 2"); 
choicel.add("Elemento 3"); 
choicel.add("Elemento 4"); 
choicel.add("Elemento 5"); 
choicel.add("Elemento 6"); 
choicel.add ("Elemento 7"); 
choicel.add("Elemento8"); 
choicel.add ("Elemento 9"); 
choicel.add ("Elemento 10"): 
choicel.add ("Elemento 11"); 
choicel.add ("Elemento 12"); 
addíchoicel); 


cholcel.adáltealdstener (this) 


Cuando el usuario hace una selección de la lista interna, usaremos el 
método getselectedltem del cuadro de lista desplegable para determinar qué 
elemento se seleccionó y luego lo visualizaremos en un cuadro de texto: 


public void itemStateChanged (1temEvent e) 
I 
if(e.getltemSelectable0 == choicel)( 
textl.setText ("Usted eligió " + 
ííChoice)e.getItemSelectable0) .getSelectedItem()); 


E Ape Wani. cho ARE 
Apia 
| | Usted eligio Elemento E 


| 
ñ 


Figura 8.6. Usar cuadros de lista desplegables. 


El resultado aparece en la figura 8.6. Como se puede ver en esta figura, los E 
usuarios pueden seleccionar un elemento del cuadro de lista desplegable, y 
cuando lo hacen, el programa visualiza ese elemento en el cuadro de texto. 


Usar barras de desplazamiento 


El programador novato' aparece y dice, "Tengo un problema. Quiero que 
los usuarios puedan seleccionar, en mi nuevo programa, el color para dibujar, 
pero están hartos de escribir los valores del color en formato hexadecimal". 
Se sonríe y le dice, "¿Por qué no usa las barras de desplazamiento? Son el 
componente perfecto cuando se quiere que los usuarios puedan seleccionar de 
un rango numérico continuo”. "Suena bien", dice PN. 

Todos los usuarios GUI están familiarizados con las barras de desplaza- 
miento. En Java, las barras de desplazamiento están formadas por unas fle- 
chas de desplazamiento (los botones que hay en cada extremo de la barra de 
desplazamiento), un cuadro de desplazamiento (cuadro que se puede deslizar) 
y un área de desplazamiento (parte de la barra de desplazamiento por la que 
se desliza el cuadro de desplazamiento). Las barras AWT se soportan con la 
clase Scrollbar, que tiene el siguiente diagrama de herencia: 
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j ava .awt . Component 
(java.awt.Scrollbar 


Los constructores de la clase Scrollbar se encuentran en la tabla 8.11 y sus 


métodos en la tabla 8.12. 
Las barras de desplazamiento no usan las interfaces ActionListener ni 


ItemListener; en su lugar, utilizan las interfaces AdjustmentListener. Esta 
interfaz sólo tiene un método, adjustmentValueChanged: 


id adjustoentValuechanged(Ad then: Event e 


Tabla 8.11. Constructores de la clase Scrollbar. 


Constructor Descripción 


Scrollbar) Crea una nueva barra de desplaza- 
miento vertical. 


Scrollbarfintorientación) Crea una nueva barra de desplaza- 
miento con la orientación dada. 


Scrollbar(int orientación, intvalor, int Crea una nueva barra de desplaza- 

visible, int mínimo, intmáximo) miento con la orientación, valor 
inicial, tamaño de la página yvalores 
mínimo y máximo dados. 


Tabla 8.12. Métodos de la clase Scrollbar. 


Método Descripción 


void addAdjustmentListener(Adjust- Añade el adjustment listenerdado, 


mentListener ) para obtenerlos eventos de ajustes. 

void addNotify0 Crea el compañero de la barra de 
desplazamiento. 

int getBlockIncrement() Obtiene el incremento de bloque de 
la barra de desplazamiento. 

int getLinelncrement() Obsoleto. Reemplazado porgetunit- 
Increment(). 

int getMaximum() Obtiene el valor máximo de la barra 


de desplazamiento. 


int getMinimum() Obtiene el valor mínimo de la barra 
de desplazamiento. 


intgetOrientation() Obtiene la orientación de la barra de 
desplazamiento. 


Método 


int getPagelncrement( ) 
int getUnitIncrement() 
int getValue() 

int getVisible() 

int getVisibleAmount() 


protected String paramString() 


protected void processAdjustment 
Event(AdjustmentEvent e) 


protected void processEvent 
(A WTEvente) 


void removeAdjustmentlistener 
(AdjustmentListener 1) 


void setBlocklncrement(int v) 
void setBlocklncrement(int v) 


void setMaximum(int newMaximum) 
void setMinimum(int newMinimum) 
void setOrientation(intorientación) 
void setPageincrement(int v) 


void setUnitlncrement(int v) 
void setValue(int newvalue) 


Descripción 


Obsoleto. Reemplazado por get- 
Blocklncrement(). 


Obtiene la unidad de incremento 
para esta barra de desplazamiento. 


Obtiene el valor actual de la barra 
de desplazamiento. 


Obsoleto. Reemplazado por getVi- 
sibleAmount(). 


Obtiene la cantidad visible de la 
barra de desplazamiento. 


Obtiene una representación de tipo 
string del estado de la barra de des- 
plazamiento. 


Procesa los eventos de ajuste que 
tienen lugaren esta barra de despla- 
zamiento enviándolos a cualquiera 
de los objetos AdjustmentListener 
registrados. 


Procesa los eventos de la barra de 
desplazamiento. 


Elimina el Adjustmentlistenerdado, 
para que nose obtengan más even- 
tos de ajuste de la barra de desplaza- 
miento. 


Fija el incremento de bloque para la 
barra de desplazamiento. 


Obsoleto. Reemplazado porsetunit- 
Increment(int). 


Establece el valor máximo. 
Establece el valor mínimo. 
Fija la orientación. 


Obsoleto. Reemplazado por set- 


BlockIncrement(). 
Fija la unidad de incremento. 


Fija el valor de la barra de desplaza- 
miento. 


Método 


void setValues(intvalor, int visible, 
int mínimo, int máximo) 


Descripción 


Fija cuatro valores para la barra de 
desplazamiento. 


void setVisibleAmount(intnewAmount) Fijaqué cantidadde barra de despla- 


zamiento es visible. 


A este método adjuternentValueChanged, se le pasa un objeto de la clase 
AdjustmentEvent. Los campos de esta clase se encuentran en la tabla 8.13, su 
constructor en la tabla 8.14 y sus métodos en la tabla 8.15. 

Observe, en particular, que se puede usar el método gerAdjustmentType de 
la clase AdjustmentEvent para determinar el tipo de evento de barra de des- 
plazamiento que se ha producido, según lo especificado en los campos de la 


tabla 8.13. 


Tabla 8.13. Campos de la clase AdjustmentEvent. 


Campo Descripción 


ADJUSTMENT-FIRST 


ADJUSTMENT-LAST 


ADJUSTMENT-VALUE-CHANGED 


TRACK 


UNIT_INCREMENT 


LUNT_DECREMENT 


BLOCKINCREMENT 


Primer ID entero del rango de ID'Sde 
eventos de ajuste. 


Marca el último ID entero del rango 
de ID's de eventos de ajuste. 


Valor de ajuste cambiado cuando se 
produce un evento. 


El usuario arrastró el cuadro de 
desplazamiento. 


El usuario hizo clic sobre la flecha de 
desplazamiento hacia la izquierda o 
sobre la de desplazamiento hacia 
arriba (oejecutó la acción equivalente 
con el teclado). 


El usuario hizo clic sobre la flecha de 
desplazamiento hacia la derecha o 
sobre la de desplazamiento hacia 
abajo (o ejecutó la acción equivalente 
con el teclado). 


El usuario hizo clic sobre la barra de 
desplazamiento, hacia la izquierda 
del cuadro de desplazamientoen una 
barra de desplazamiento horizontal, | 
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Descripción 


BLOCK-DECREMENT 


o por encima del cuadro en una barra 
de desplazamiento vertical. La tecla 
Repág es equivalente. 


El usuario hizo clic sobre la barra de 
desplazamiento, hacia la derecha del 
cuadro de desplazamiento en una 
barra de desplazamiento horizontal, 
o por encima del cuadro en una barra 
de desplazamiento vertical. La tecla 
Avpág es equivalente. 


Tabla 8.14. Constructor de la clase AdjustmentEvent. 


Constructor 


Descripción 


AdjustmentEvent(Adjustable,source, Construye un objeto Adjustment- 


int type, int value) 


Event, con el id ajustable fuente, tipo 
de evento, tipode ajuste yvalor dados. 


Tabla 8.15. Métodos de la clase AdjustmentEvent. 


Método 


Adjustable getAdjustableO 


| int getAdjusimentType() 


int getValue() 


String paramString() 


del estado del evento. 


Descripción 
Obtiene el objeto ajustable en el que 
se originó el evento. 


Obtiene el tipo de ajuste que produjo 
el evento que cambió el valor. 


Obtiene el valor actual del evento de 
ajuste. 


Obtiene una representacióntipostring 


Veamos un ejemplo. Aquí, añadiremos dos barras de desplazamiento a un 
programa y visualizaremos sus propiedades cuando el usuario se desplaza por 
ellas. Cuando se construye una barra de desplazamiento, se puede especificar 
su orientación (horizontal o vertical), su valor inicial, tamaño de página y su 
rango numérico. El tamaño de página indica el tamaño del cuadro de despla- 
zamiento (se tiene por costumbre utilizar el tamaño del cuadro de desplaza- 
miento para indicar el rango total, se usa un cuadro más pequeño para un 
rango más grande y uno más grande para un rango más pequeño, como se 
puede ver en los procesadores de texto cuando se trabaja con documentos de 


distintos tamaños). Asíes cómo se añade una barra de desplazamiento a un 
programa, dándole una orientación horizontal, un valor inicial de 1, un tama- 


ño de página de 20 y un rango de 1a 200: 


import java.applet.Applet; 
import java.awt.event.*; 
import Java.awt. a 


public class desplazamientoextendsApplet implements AdjustmentListener 
{ 


TextField textl; 
Scrollbar scrolll, scroll2: 


public void inito0 


( 
scrolll = new Scrollbar (Scrollbar.HORIZONTAL, 1, 20, 1, 200); 


add (scroll11); 
scrolll.addAdjustmentListener (this); 


Observe que además hemos añadido un AdjustmentListener a esta nueva 
barra de desplazamiento. 


Truco: se podría pensar que esta barra de desplazamiento puede devol- 
| ver cualquier tralor detitro del rango de 1 a 200, pero de hecho, el 
cuadro de desplazamiento debe además estar representado en el cuadro 
de desplazamiento, por lo que la barra só 10 puede devolve:r valore + de | 
a 200 menos el tamaño de la página (20, en este:caso), jue es igual a 
130. Es algo en do que hay que pensar cuanao se crean parras de 


desplazamiento. 


La barra de desplazamiento también se puede configurar usando los méto- 
dos setUnitIncrement y setBlocklncrement. El método setUnitIncrement 
establece la cantidad de cambios de propiedades de la barra de desplazamien- 
to cuando el usuario hace clic sobre una fecha de desplazamiento (el defecto 
es I), y el método setBlockIncrement fija la cantidad de cambios de propie- 


dad que tienen lugar cuando el usuario hace clic en el cuadro de desplaza- 
miento (el defecto es 10). 
A continuación, se añade un cuadro de texto que visualiza las nuevas 
propiedades de las barras de desplazamiento, en el caso de que sea vertical: 
public void init () 
I 
scrolll = new Scrollbar(Scrollbar.HORIZONTAL, 1, 20, 1, 200); 
add (scrolll1); 
scrolll.addAdjustmentListener (this); 
textl = new TextField(20); 
add (text1); 
scroll2 = new ~crollbar (Scrollbar .VERTICAL, 1, 20, 1, 200); 
add (scrol12); 


scrol12.addAdjustmentListener (this); 
1 


Todo lo que queda es actualizar lo que se visualiza en el cuadro de texto 
cuando el usuario utiliza las barras de desplazamiento. Esto lo hacemos con 
el método adjustmentValueChanged, verificando el método getAdjustable 
del objeto AdjustmentEvent para asegurarse que se está tratando una de las 
barras de desplazamiento, y usando el método get Value de la barra de despla- 
zamiento para visualizar las nuevas propiedades del cuadro de texto. Así 
sería el código: 


public void adjustmentValueChanged (AdjustmentEvent e) 


{ 
if(e.getAdjustable0 == scrolll 11 


e.getAdjustable0 == scrol12) ( 
textl.setText ("Horizontal : "4 scrolll.getValue() + 
" Vertical: " + scroll2.getvalueo); 


3 


El resultado se muestra en la figura 8.7. Como se puede ver en esta figura, 
el usuario puede mover las barras de desplazamiento y sus nuevas propieda- 
des aparecerán en el cuadro de texto. Este ejemplo está en el CD en 
desplazamiento.java. 

Eso está bien si se quieren usar barras de desplazamiento que permit~mı 
usuario especificar fácilmente los números de cualquier rango continuo, pero 
¿qué pasa si se quieren usar barras de desplazamiento para recorrer algo? A 
continuación, veremos otro ejemplo que recorre una cadena de texto en un 
applet. 

En este caso, moveremos la cadena "¡Hola desde Java!" con un applet paray 
obtener las propiedades de una barra de desplazamiento. Empezaremos creando 
la barra de desplazamiento y pintando la cadena en la coordenada (x, 60) 
donde ajustaremos x cuando se mueva la barra de desplazamiento: 


1 


import jJava.applet.Applet; 
import java.awt.event.*; 
import Java.awt.*; 


public classdesplazamiento2extends Applet implements AdjustmentListener 


{ 
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Figura 8.7. Usar barras de desplazamiento. 


Scrollbar scrolll, scroll2; 
int x = 05 


public void init () 
1 


scrolll = new Scrollbar (Scrollbar.HORIZONTAL, 1, 10, 1, 100); 
add (ecrol11); 


scrolll.addAdjustmentListener (this); 
1 


public void paintíGraphics g) 
1 
g.drawString("yRola desae Javaln, Xx, 60); 


Cuando se produzcan los eventos de desplazamiento, lo notificaremos en 
el métodoadjustmentValueChanged, y se puede fijar el valor de la variable x 
para reflejar la nueva situación horizontal de la cadena y volver a dibujar la 
applet (observe que se está usando el método getSize de la clase Applet para 
determinar la anchura de la applet y escalar los movimientos de la cadena de 
texto de acuerdo con ello): 


public void adjustmentValueChanged (AdjuctmentEvent e) 


{ 
if (e.getAdjustable0 == scrolll) ( 1 
x = (int) (getSize().width * (float) scrolll.getValue() / 
100); 
repaint ()5 


El resultado se muestra en la figura 8.8. Como se puede ver en esta figura, 7 
el usuario puede desplazarse por la cadena de texto simplemente manipulan- 
do la barra de desplazamiento horizontal. Este ejemplo se encuentra en el CD 
como desplazamiento2.java. 

Veremos con más detalle el desplazamiento por textos con las barras de7 
desplazamiento en el siguiente punto. 


A y 
| Aple Where desp M ES 


¡Hola desde Java! 


Figura 8.8. Desplazamiento por una cadena de texto. 


Barras de desplazamiento y border layouts 


TZ 
"Vaya", dice el programador novato, "ahora el gran jefe quiere que añada 


a mi programa barras de desplazamiento horizontal y vertical, pero no se 
mantienen en el lugar en que yo las puse”. "Eso se debe a que debería usar un 
border layout", le contesta. 

Dado que los border layouts permiten añadir controles alrededor del perF 
metro de un programa, es natural utilizarlos con barras de desplazamiento- 
Este es un ejemplo en el que añadiremos cuatro barras de desplazamiento 
alrededor del panel central. Este panel visualiza el texto "¡Hola desde -ava!" 
en la posición (x, y), como sigue: 


class textpanel extends Panel 


( 


TextField Textl; 


public int x = 0, y = 0; 


public void paint (Graphics g) 


( 
1 


g.drawString("iHoladesde Java!", X, y); 


A continuación, se puede añadir un objeto de esta nueva clase panel en el 
centro del border layout, rodeándolo con barras de desplazamiento, como 


sigue: 


import java.applet.Applet; 
import java.awt.* ; 
import java.awt.event.*; 


public 


class desplazamientoenborde extends Applet implements 


AdJustmentListener 


I 


Scrollbar hscrol11, hScrol12, vscrol1l1, vScrol12; 
textpanel tl; 


public void init () 


I 


setLayout (new BorderLayout ()); 


hScrolll = new Scrollbar (Scrollbar.HORIZONTAL, 1, 1, 1, 100); 
add (nNorth", hscrolll); 
hscrol11l.addAdjuetmentListeneríthis); 


vScrolll = new Scrollbar (Scrollbar.VERTICAL, 1, 1, 1, 100); 
add ("Westn, vScrol11); 
v-=crolll.addAdjustmentListener (this); 


hScrol12 = new Scrollbar (Scrollbar.HORIZONTAL, 1. 1, 1, 100); 
add ("Southm, hScrol12); 
hscroll12.adaAdjustmentListener (this) ; 


v+croll2= new Scrollbar (Scrollbar.VERTICAL, 1, 1. 1, 100); 
add ("EastW, vScrol12); 


vieroll1.-«dlid justas tListener (this) 


tl = new textPanel0; 
add ("Centern, tl); 


El único truco es que cuando el usuario mueve una barra de desplazamien? 
to, hay que mover la correspondiente en el otro lado del panel central para 
mantener la coordinación entre las barras de desplazamiento. Asíes como se 


haría con el método adjustment ValueChanged: 


public void adjustmentValueChanged (AdjustmentEvent e) 
if(e.getAdjustable0 == hScrol1l1)< 

hScrol12.setValue (hScrol1l1 .getvalueo) ; 

1 

if (e.getAdjustable0 == vScr0111)C 
vScroll2.setValue (vScrol11.getvalueo) ; 

1 

if (e.getAdjustable0 == hScrol12)C 
hScrolll.setValue (hScr0112-getvalueo); 

1 

if(e.getAdjustable0 == vScrol12)C 
vScrolll.setValue (vScrol12.getvalueo) ; 


1 


Lo único que queda es obtener las propiedades de las nuevas barras d? 
desplazamiento, ajustar la posición x e y de la cadena de texto en el panel y 
luego volver a dibujar el panel. El proceso es el siguiente: 


public void adjustmentValueChanged (AdjustmentEvent e) 
{ 

if(e.getAdjustable() == hScrol11) 
hScrol12.setValue (hScrol1l1.getvalueo); 

1 
if(e.getAdjustable0 == vScrol11i 
vScroll2.set-alue (vScrolll.getvalue”)); 

1 
if(e.getAdjustable( == hScrol12) 
hScrolll.set-alue(h-croll2.get-alueo0); 

1 
if(e.getAdjustable0 == vScrol12) 
vScrolll.setValue (vScrol12.getvalueo); 


tl.x = (int) (getSize () .width * (float) hScrol11.getValue() / 
tl.y = (int) (getSize() .height il (float) vScroll1.getvalue() / 


tl.regainto; 
1 


Y eso es todo. El resultado se muestra en la figura 8.9. Como se puede ver 
en ella, las barras de desplazamiento aparecen alrededor del perímetro de la 
applet. Este ejemplo está en el CD como desplazamientoenborde.java. 

Hay otra forma fácil de desplazarse por el texto en paneles: se pueden usar 
las áreas de desplazamiento, que lo veremos después. 


| Hola desde Java! 


i 
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Figura 8.9. Barras de desplazamiento en un border layout. 


Usar cuadros de desplazamiento 


"Quiero desplazar algo de texto", dice el programador novato, "pero la 
configuración de las barras de desplazamiento es demasiado trabajo. ¿NOhay 
una forma más fácil?" "Claro", le dice. "Puede usar los cuadros de desplaza- 
miento". "¡Bien!", dice PN. 

Se puede añadir un componente a un cuadro de desplazamiento, y le 
permitirá desplazarse alrededor del componente. Si el componente es más 
grande que el cuadro de desplazamiento, sólo será visible de una vez una 
parte del componente. Este es el diagrama de herencia de la clase ScrollPane: 


java.lang.Object 
ljava.awt.Component 
ljava.awt.Container 
Ijava.awt.ScrollPane 


Se pueden encontrar los campos de la clase ScrollPane en la tabla 8.16," 
sus constructores en la tabla 8.17 y sus métodos en la 8.18. 


Tabla 8.16. Carn-ogle la clase ScrollPane. 
Campo Descripción 


| static int SECROLLBARS ALWaArS indica que las barras de desplaza 
miento haorizontal'vertical siempre 
| deberían aparecer. 
static int SCROLLBARS-AS-NEED Indica que las barras de desplaza- 
miento horizontal/vertical deberían 
aparecer sólo cuando el tamaño del 
hijo sea mayor que el del panel de 
desplazamiento. 


static int SCROLLBARS-NEVER Indica que las barras de desplaza- 
miento horizontal/verticalno se de- 
berían mostrar nunca. 


Tabla 8.17. Constructores de la clase ScrollPane. mS 


Constructor Descripción 


SoroliPanej) Crea un nuevo cuadro de desplaza- 
miento. 


ScrollPane(intscrollbarDisplayPolícy) Crea un nuevo cuadro de desplaza- 
miento, utilizando una política de 
visualización. 


Tabla 8.18. Métodos de la clase ScrollPane. 


Método i Descripción 


protected void addlmpl(Component Añade al cuadro de desplazamiento 
como, Object constraints, intíndice) el componente dado. 


void addNotify () Crea el compañero del cuadro {ë 
desplazamiento. 


void doLayout() Adapta este contenedor redim*!" | 
donando el componente contenta 
a su tamaño preferido. 


Adjustable getHAdjustable() Obtiene la barra de desplazamiento 
horizontal. 


Método Descripción 


int getHScrollbarHeigh t() Obtiene la altura que debería ocupar 
una barra de desplazamiento hori- 
zontal. 

intgetScrollbarDisplayPolicy() Obtiene la política de visualización 


de las barras de desplazamiento. 


Point getScrollPosition() Obtiene la posición actual x, ydentro 
del hijo, que es visualizado en el 
origen de la parte visible del panel 
de desplazamiento. 


Adjustable getVAdjustable() Obtiene la barra de desplazamiento 
vertical. 
Dimension getViewportSize() Obtiene el tamaño actual de la vista 


del panel de desplazamiento. 


int getVScrollbarWidth() Obtiene la anchura que debería ser 
ocupada por la barra de desplaza- 
miento vertical. 


void layout() Obsoleto. Reemplazado por doLa- 
vouto. 
String paramString() Obtiene una representación de tipo 


stringdelestado de este contenedor. 


void printComponents(Graphics g) Visualiza el componente en este 
cuadro de desplazamiento. 


void setLayout(LayoutManager mgr) Fija el layout manager para este 
contenedor. 


void setScrollPosition(int x, inty) Desplaza a la posición dada dentro 
del componente hijo. 


void setScrollPosition(point p) Desplaza a la posición dada dentro 
del componente hijo. 


Veamos un ejemplo. Es bastante fácil añadir un componente a un cuadro 
de desplazamiento, simplemente hay que usar el método add de la clase 
ScrollPane. Así es como se haría cuando se quiere añadir un cuadro de texto 
aun cuadro de desplazamiento: 


import java.applet.Applet; 
import java.awt.*; 
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public class cuadrodedesplazamientoextends Applet 


I 


ScrollPane scrollpanel; 
TextPanel tl: 


public void init0 
t 
scrollpanel = new Scrollpaneo; 
textl = new TextField("iHola desde Java!"); 
scrollpanel .addítextl); 
add (scrollpanel); 
1 


1 


Sin embargo, es curioso cuando sólo una parte del cuadro de texto a 
visible en un cuadro de desplazamiento. Más interesante sería incluir despla- 
zamiento de texto en un panel, y ahora veremos un ejemplo. En este caso, 
crearemos una nueva clase panel, TextPanel, que visualiza una larga cadena 
de texto: 


class TextPanel extends Panel 
{ 


public void paint (Graphics g) 
t 


g.drawString ("Esta es una cadena de texto larga que + 
"parece continuar y continuar y continuar....", 0, 60); 


Hay un punto importante que la mayoría de los libros nunca tratan: cuand? 
se usa un objeto que no tiene un tamaño predefinido, como un panel eN un 
cuadro de desplazamiento, se tiene que dar un tamaño. En el caso d2 los 
contenedores y de los paneles, eso quiere decir que hay que sobrescrik)ir el 
método getPreferredSize para que se pueda llamar al método desde el cu adra 
de desplazamiento. Aquí se devuelve un objeto de la clase Dimension, WWW 
sólo tiene dos miembros de datos, anchura y altura. Estos valores se estjabhé 
cen como sigue: 

class TextPanel extends Panel 

I 


public Dimension getPreferredSize0 
1 


return new Dimension(400, 400): 


y 


public void paint (Graphicsg) 
1 


g.drawString ("Esta es una Cadena de texto larga que " + 
"parece continuar y continuar y continuar....", 0, 60); 


1 


Ahora, añadiremos un objeto de la clase TextPane a un cuadro de despla- 
zamiento, como sigue: 


import java.applet.Applet; 
import java.awt.*:; 


public class scrollpane extends Applet 
{ 


ScrollPane scrollpanel; 
TextPanel tl; 


public void init()( 
scrollganel = new Ss + - = == PD === (so oPD ==». SCROLLB 


tl = new TextPanelo; 
scrollpanel .add (t1); 
add (scrollganel); 


Figura 8.10. Dosplazarse por un texto utilizando un cuadro de desplazamiento. 
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El resultado se muestra en la figura 8.10. Como se puede ver en esta7 
figura, el usuario finaliza el desplazamiento por el texto en el interior de un 
cuadro de desplazamiento, en lugar de desplazarse por algún control como es 


un cuadro de texto. Este ejemplo se encuentra en el CD como cuadrodedespla- 
zamiento.java. 


EJ AWT: Gráficos, 
imagenes, texto 
y fuentes 


Este capítulo trata sobre los temas potenciales de Java: gráficos, imáge- 
nes, gestión de textos y el trabajo con las fuentes. Java es un lenguaje muy 
visual y todas estás áreas son conocidas por los programadores. Empezare- 
mos con una visión rápida de estos elementos. 


Gráficos 


La capacidad de gráficos de AWT es bastante sólida y se basa en la gran 
clase Graphics. Dicha clase se puede utilizar para dibujar cualquier tipo de 
figuras, rectas, puntos, rectángulos, óvalos, polígonos y algunos otros. Ade- 
más, es posible seleccionar los colores, los modos de dibujo y colorear las 
figuras. Veremos todo esto en este capítulo, incluyendo también un componente 
especial, Canvas, que existe expresamente para que se pueda dibujar en él. 


Imágenes 


En AWT hay que destacar la gestión de imágenes y veremos lo que es 
capaz de hacer alo largo de este capítulo. Echaremos un vistazo a las diversas 


formas de cargar imágenes de diferentes formatos como GIF y JPG, 
redimensionamiento de imágenes, espera hasta que las imágenes estén total- 
mente cargadas antes de visualizarlas, dibujar imágenes antes de visualizarlas 
(proceso llamado double buffering),y animación de imágenes. De hecho, es 
posible acceder a cada uno de los pixels de las imágenes, y haremos eso aquí, 
copiando imágenes, dándoles brillo, convirtiéndolas a una escala de grises y 
dándoles una apariencia de grabado. 


Truco: aprenderemos todo sobre la animación de imágenes y el de 
buffering cuando veamos los multihilos, más adelante. 


Texto y fuentes 


Quizás le resulte sorprendente ver que se tratan el texto y las fuentes eniEF 
capítulo de gráficos, pero cuando se escribe texto directamente, sin insertarlo 
en un control como un cuadro de texto, se está creando un gráfico y Java lo 
trata como tal. En este capítulo, veremos un poco más sobre el trabajo con 
textos como si fueran gráficos. Por ejemplo, se verá cómo fijar la fuente y el 
estilo del texto, como cursiva o negrita, y cómo medir el tamaño de una 
cadena.detexto en la pantalla, por lo que se puede centrar en una ventana. 


Teclado y ratón 


En este capítulo, escribiremos código que permita visualizar texto directa 
mente, sin ningún control como cuadros de texto o áreas de texto, lo que 
quiere decir que tendremos que leer ese texto directamente del teclado. Por lo 
tanto, .veremos aquí la gestión de la entrada de datos por el teclado. 
Adicionalmente, cuando se está permitiendo al usuario la creación de gráfi- 
cos, el ratón es una herramienta útil; de hecho, en este capítulo crearemos un 
programa de dibujo con ratón, por lo tanto, echaremos un vistazo a cómo se 
codifica el uso del ratón. Empezaremos este capítulo revisando el uso del 
ratón y del teclado. 

Eso es todo. Ya hemos revisado rápidamente lo que hay en este capítulo. 
Pasemos a la siguiente sección. 


Usar el ratón 


"De acuerdo", dice el programador novato, "en mi programa, el usuarm 


puede seleccionar texto con Control-Alt-F8, mover el cursor de inserción 


con Mayús-Alt-F3, y..." "Espere un minuto", le dice. "¿Ha pensado en incor- 
porar el soporte del ratón a su programa? Será más fácil para el usuario". 
"Hmm", dice el programador, recapacitando. 

Se puede trabajar con el ratón usando dos interfaces AWT, MouseListener, 
que gestionan los clics con el ratón, el apretar o soltar sus botones, así como 
el caso en que el ratón introduzca un componente y luego lo abandone, y 
MouseMotionListener, que gestiona los movimientos de ratón y las operacio- 
nes de arrastre. Los métodos de la interfaz MouseListener se recogen en la 
tabla 9.1 y los de MouseMotionListener en la tabla 9.2, 


Tabla 9.1. Métodos de la interfaz MouseListener. 


Método Des erpelóon 


void mouseClicked(MouseEvente) Sele llama cuando se ha hecho clic, 
con el ratón, en un componente. 


void mouseEntered(MouseEvent e) Se le llama cuando el ratón introduce 
un componente. 


void mouseExited(MouseEvente) Se le llama cuando el ratón sale de 
un componente. 


void mousePressed(MouseEvent e) Se le llama cuando se presiona un 
botón del ratón en un componente. 


voidmouseReleased(MouseEvente) Se le llama cuando se suelta un 
botón del ratón en un componente. 


Tabla 9.2. Métodos de la interfaz MouseMotionListener. 


Método Descripción 


voidmouseDragged(MouseEvente) Se le llama cuando se aprieta un 
botón del ratón en un componente y 
luego se arrastra. 


void mouseMoved(MouseEvent e) Se le llama cuando el ratón se ha 
movido sobre un componente (sin 
apretar botón). 


A cada uno de los métodos de las interfaces de ratón se le pasa un objeto 
de la clase MouseEvent, y el diagrama de herencia de esa clase es como sigue: 


java.lang.Cbject 
Ijava.util.EventObject 
ljava.awt.AWTEvent 
ljava.awt.event.ComponentEvent 
ljava.awt.event.InputEvent 
Ijava.awt.event.MouseEvent 


La clase MouseEvent añade sólo los campos a sus clases base. Los campos 
de esta clase se encuentran en la tabla 9.3. 


Tabla 93. Campos de la clase MouseEvent. 


Campo Descripción 


static int MOUSE-CLICKED Indica el evento "rnouseclicked". 
static int MOUSE-DRAGGED Indica el evento "rnouse dragged". 
static int MOUSE-ENTERED Indica el evento "rnouse entered". 
static int MOUSE EXITED Indica el evento "mouse exited". 

static int MOUSE- FIRST Indica el primer número del rango de 


ID'Susado para los eventos de ratón. 


static int MOUSELAST Indica el último número del rango de ID's 
usado para los eventos de ratón. 


static int MOUSE-MOVED Indica el evento "rnouse moved" 
static int MOUSE- PRESSED Indica el evento 'rnouse pressed. 
static int MOUSE-RELEASED Indica el evento "rnousereleased". 


Veamos un ejemplo. Esta applet, mouse-java, visualizará la mayor parte 
de lo que se puede hacer con el ratón. Para capturar las acciones especíHicab 
del ratón, sobrescribimos el correspondiente método rnouse listener. Para 
obtener la posición actual del ratón de un objeto MouseEvent, se usan los 
métodos getX y getY. Para saber qué botón se presionó, se puede usar el 
método getModifiers de la clase MouseEvent y luego se añade el resultado 
con los campos siguientes de la clase InputEvent : ALT-GRAPH-MASK, 
ALT-MASK, BUTTONI-MASK, BUTTON2_MASK, BUTTON3_MASK, 
CTRL-MASK, META-MASKy SHIFT-MASK. Asíes el código de estaapplet, 
mouse.java: 


import java.applet.Applet; 
import java.awt.*; 


import java.awt.event.*; 


public class raton extends Applet implements MouselListener, 
MouseMotionListener 


( 
TextField textl; 


public void init ()( 
textl = new TextField(35); 
add (textl):; 
addMouseListener (this); 
addMouseMotionListener (this); 


} 


public void mousePressed (MouseEvent e) 
I 
if((e.getModifiers0 8 InputEvent.BUTTON1-MASK) == 
InputEvent . BUTTOU1-MASK) ( 
textl.setText ("Botón izquierdo del ratón apretado en " + e.getX0 + 
„+ e.getY0); 
1 
else< 
textl.setText ("Botón derecho del ratón pulsado en m + e.getX0 + 
+ e.getYo0); 
1 


public void mouseClicked(MouseEvent e) 
I 

textl.setText ("Hizo clic sobre el ratón en " + e.getX0 AT 
+ e.getY0); 


1 


public void mouseReleased (MouseEvent e) 


{ 


textl.setText ("Se soltó el botón del ratón."); 


public void mouseEntered (MouseEvent e) 
I 


textl.-etText (“Ratórpara introducir."); 


public void mouseExited(MouseEvent e) 
I 


textl.set-ext ("“atópara salir."); 


public void mouseDragged (MouseEvent e) 
t 


textl.setText ("Se arrastró el ratón."); 


) 


public void mouseMoved (MouseEvent e) 


{ 
te-tl.setText (~Smovió el ratón."); 
1 
l 


Se puede ver esta applet funcionando en la figura 9.1. Cuando se mueve el 
ratón o se usa uno de sus botones, la applet permite saber lo que ocurre. Este 
ejemplo está en el CD que acompaña a este libro, como raton.java. 


Ebim dicas be: i das ai i ha 


Figura 9.1. Usar el ratón. 


Usar el teclado 


"Bien", dice el programador novato, "estoy escribiendo un procesador de 
texto, SuperDuperTextPro, en Java y quiero leer el texto directamerite del 
teclado. ¿Cómo funciona eso?" "Con el key listener", le dice. "Sabía que 
habría algo que me gustaría”, dice PN. 

Se usa la interfaz keyListener para trabajar con el teclado, y se pueds 
encontrar sus métodos en la tabla 9.4. 


Observe que hay tres eventos de tecla diferentes: tecla pulsada, soltar la 
tecla y escribir. Generalmente se usa el evento de escritura cuando se está 
trabajando con el teclado, porque se puede usar el método getKeyChar en 
keyTyped para obtener el carácter Unicode que se escribió. Por otro lado, en 
los métodos KeyPressed y KeyReleased se puede usar el método getKeyCode 
(no getKeyChar) para obtener un código virtual de la tecla; este código sólo 
dice que la tecla fue presionada o soltada, cada uno es responsable de averi- 
guar si se pulsaron la tecla Mayús, Control u otra tecla, lo que se puede 
hacer con el objeto KeyEvent que se le pasa a los métodos de eventos de 
teclas. Para saber las teclas modificadoras (como Mayús) que se pulsaron, se 
puede usar el método getModifiers del objeto KeyEvent y luego añadir el 
resultado con los campos de la clase InputEvent: ALT-GRAPH-MASK, 
ALT-MASK, CTRL-MASK, META-MASK y SHIFT-MASK. 

En general, no es muy fácil trabajar con los códigos virtuales porque hay 
una constante separada de los códigos que devuelve getKeyCode para cada 
tecla, poro ejemplo, VK-Fl para la tecla F1, VK-A para el carácter A. VK-5 
para el número 5, etc., como se enumera en los campos de la clase KeyEvent, 
que se pueden ver en la tabla 9.5. Además, los constructores de esta clase se 
recogen en la tabla 9.6 y sus métodos en la tabla 9.7. Este es el diagrama de 
herencia para esta clase: 


AA 


Tabla 9.4. Métodos de la interfaz KeyListener. 


Método Descripción 

void keyPressed(KeyEvent e) Se le llama cuando se pulsa una 
tecla. 

void keyReleased(keyEvent e) Se le llama cuando se suelta una 
tecla. 

void keyTyped(keyEvent e) Se le llama cuando se escribe con 
una tecla. 


Tabla 9.5. Campos de la clase KeyEvent. 


CHAR-UNDEFINED KEY-FIRST KEY-LAST 
KEY-PRESSED KEY-RELEASED KEY-TYPED 


VK_G0a VK_9 
WK_ACCEPT 
WK_ALL_ CANDIDATES 
WK_ALT_GRAPH 
WK_AT 
VK_BACK_SPACE 
WK_CAMNCEL 
WK_CLEAR 
WkK_COLON 
WK_CONTROL 
WK_GcuT 


WE_DEAD ACUTE 
WK_DEAD_CEDILLA 


VK-DEAD-DOUBLE- 
ACUTE 


VK_DEAD_MACRON 
VK_DEAD_TITLE 


VK_DELETE 
VK_DOWN 
WK_EQUALS 


WK- EXCLAMA TION- 
MARK 


WE_FIND 
VEK_HALF_WIDTH 
VK_HOME 


Vk-JAPANESE-HIRA- 
GANA 


WE_KANA 


WA a 

VK-ADD 
VK-ALPHANUMERIC 
VK-AMPERSAND 
Wk_BACK_QUOTE 
VK_BHACELEFT 
VK_CAPS_LOCK 
WK_CLOSE BRACKET 
VK_COMMA 
WVK_CONVERT 


VK_DEAD ABOVEDOT 
WE_DEAD_ABOVERING 


WR_DEAD BREVE 


VK-DEAD-CIRCUM- 
FLEX 


VK_DEAD_GHAWE 


VK_DEAD_OGONEK 


VK-DEAD-VOICED- 
SOUND 


WE_DIVIDE 
VK_END 
WKE_ESCAPE 
VK_F1a VK_F24 


WK_FULL_WIDTH 
VK-HELP 
VK-INSERT 


VK-JAPANESE-KA- 
TAKANA 


WE_KANJI 


VK-Z 

VK-AGAIN 

VK-ALT 

VK-ALT 
VK_BACK_SLASH 
WK _BRACERIGHT 
WK_CIACUMPFLEX 
WK_CODE_INPUT 
VYK_COMPOSE 
WK_COPY 


VK_DEAD_CARON 


VK-DEAD-DIERE- 
SIS 


VK_DEAD_IOTA 


VK_DEAD_SEMIWOIl- 
CED_SOUND 


VK-DECIMAL 


VK_DOLLAR 
WKE_ENTER 
VWK_EURO SIGN 
VE_EINAL 


VK_GREATER 
VK-HI RAGANA 


VK-INVERTED-EX- 
CLAMATION-MARK 


VK-JAPANESE-RO- 
MAN 


VE_KATAKANA 


WK_KP_DCHAIAN 
VK-KP-UP 


VK-LESS 
VK_MODECHANGE 
VK_NLIM_LOCK 


VK_OPEN_BRACKET 
VK_PASTE 
VK_PLUS 


VK_PROPS 
VK-RIGHT 


WK_SCROLL_LOCK 
VK-SHIFT 
VK-STOP 
VK-UNDEFINED 
VE_UP 


WR_KP_LEFT 
VK-LEFT 


VK-M ETA 
VK_MULTIPLY 


WK_NLUMBER_ SIGN 


VK_PAGE_DOWN 
WH_PALSE 


VEK PREVIOUS CAN: 


DIDATE 
VK_QUOTE 


VK-RIGHT-PAREN 
THESIS 


WK_SEMICOLON 
VK-SLASH 

VK-SU BTRACT 
VK-UNDERSCORE 


VR_KP_RIGHT 


VK-LEFT-PAREN- 
THESIS 


VK-MINUS 
WK_NONCONVERT 


VE_QNUMEPADO a VK_ 
NUMPADO 


VK_PAGE_UP 
VK_PERIOD 
VE_PRINTSCRHEEN 


VK_OUCTEDBL 


VK-ROMAN-CHA- 
RACTERS 


VK_SEPARATER 
VK-SPACE 
VK-TAB 
VK-UNDO 


Tabla 9.6. Constructores de la clase KeyEvent. 


Constructor 


Descripción 


KeyEvent(Componentfuente, int id, long Crea un objeto KeyEvent. 
cuándo, intmodificadores, int keyCode) 


KeyEvent(Componentfuente, int id, long Crea un objeto KeyEvent. 
cuándo, intmodificadores, int keyCode, 


char KeyChar) 


Tabla 9.7. Métodos de la clase KeyEvent . 


Metodo 


char geiKeyChar0 


int getKeyCode0 


Obtiene el carácter asociado con 
la tecla en este evento. 


Obtiene el código entero de la 
tecla asociado a este evento. 
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Método 


static String getKeyModifiers Text 
boolean isActionKey() 


String pararnString() 
void setKeyChar(char keychar) 


void setKeyCode(intkeycode) 


(int 


void setModifiers(int modificadores) 


Descripción 


Obtiene un Stringque describe el 


dificador)keycode , como 
Na 


Determinasi la tecla de este even- 
to es una tecla de acción, como 
se define en Event.java. 


Obtiene una cadena identificando 
este evento. 


Fija el valor KeyCharparaindicar | 
un carácter. 


Fija el valor de keyCode para in- 
dicar una tecla física. 


Fijalos modificadorespara indicar 
la teclas adicionales que fueron 
mantenidas (Mayús, Control, Alt, 
etc.). Definidocomoparte de Input- 
Event. 


Veamos un ejemplo. Esta applet sencilla lee y visualiza las teclas, usando 
el evento keyTyped y el método getKeyChar para leer cada tecla. Cada vez 
que el usuario pulsa una tecla para escribir, el carácter correspondiente se 
añade al final de la cadena visualizada. Así es la applet: 


import java.awt.*; 
import java.awt.event.*; 
import java.applet.Applet; 


public class tecla extends Applet implements KeyListener ( 


String text = ""; 


public void hito 

I 
addKeyListener (this); 
requestFocus () 5 


public void paint (Graphics g) 
I 

g.drawString (text, 0, 100); 
> 


public void keyTyped (KeyEvent e) 
c 
text = text + e.getKeyChar0; 
repaint ()5 


public void keyPressed (KeyEvent e) O 
public void keyReleased (KeyEvent e) {} 


1 


Aquí hay que observar una cosa: para que laappler, en sí misma, reciba las 
pulsaciones, hay que darle el foco. (En un GUI, un elemento que tiene el foco 
es el que recibe las pulsaciones). Hacemos esto con el método requestFocus 
de la applet; si no se da el foco a la applet de forma explícita, no se verá 
ninguno de los caracteres escritos. 

Los resultados de este código se muestran en la figura 9.2. Como se puede 
ver, el usuario puede escribir texto directamente en esta applet, que funciona 
como se esperaba. Este ejemplo está en el CD con el nombre tecla.java. 

Esto es sólo el comienzo del trabajo con texto. Ahora veamos el siguiente 
tema, en el que empezaremos con las fuentes. 


E Apii ems trola diari 
pad 


[Estetexto se ha escrito directamente en esta appletl 


Figura 9.2. Usar el teclado. 


Usar fuentes 


"El hanner que se creó para la empresa Pride Picnic era bueno", dice el 
gran jefe (GJ), "pero no parece estar hecho con orgullo". "¿Por qué no?", le 


pregunta. "Por una cosa", dice GJ, "medía sólo un cuarto de pulgada de alto". 
"Hmm", le dice, "me quiere decir que sería mejor usar una fuente más gran- 
de". 

Se puede seleccionar el tipo y el estilo de las fuentes del texto con la clase 
Font. Usando esta clase, se puede seleccionar una fuente (como helvética, 
arial o courier), fijar su tamaño y especificar si está en negrita, cursiva, etc. 
Encontrará los campos de la clase Fonten la tabla 9.8, sus constructores en la 
tabla 9.9 y sus métodos en la tabla 9.10. 

Por si todos los métodos de la tabla 9.10 no son suficientes, hay otra clase 
importante, la clase FontMetrics, que trata de las dimensiones físicas de las 
fuentes. El campo de esta clase aparece en la tabla 9.11, su constructor en la 
tabla 9.12 y sus métodos en la 9.13. Uno de los usos más comunes de la clase 
FontMetrics es determinar la altura del texto cuando se visualizan varias 
líneas de texto. 

Revisemos las tablas para ver aquello de lo que disponemos cuando traba- 
jamos con fuentes. 


Tabla 9.8. Campos de la clase Font. 
Descripción 
protected Fontfuente Fuente desde la quese crean las métricas. 
static int BOLD Estilo negrita. 


static int CENTER-BASELINE Línea de base usada en los scripts 
ideográficos (como la japonesa). 


static int HANGING-BASELINE Línea de base usada cuando se esque- 
matizan los scripts como Devenagari. 


static int ITALIC Estilo cursiva. 
protected Stringnombre Nombre lógico de esta fuente. 
static int PLAIN Estilo liso. 


protected float pointsize Tamaño del punto de esta fuente en un 
float. 


static int ROMAN-BASELINE Línea base usada en la mayor parte de los 
scripts roman cuando se esquematiza el 
texto. 


protected inttamaio Medida del punto de esta fuente. 


protected intestilo Estilo de esta fuente. 


Tabla 9.9. Constructores de la clase Font 


Constructor Descripción 


| FontiMap atributos) Crea una nueva fuente con los atributos 
dados. 


Font(String nombre, intestilo, Crea una nueva fuente con el nombre, es- 
inttamaño) tilo y tamaño de punto dados. 


Tabla 9.10. Métodos de la clase Font. 


Método Descripción 


| boolean canDisplay(charc) Verifica si la fuente tiene algúnglyph para | 
el carácter dado. 


int canDisplayUpTo(char[jtexto, Indica si esta fuente puede visualizar los 
intinicio, ¡nt límite) caracteres del texto dado. 


intcanDisplayUpTo(Character- Indica si esta fuente puede visualizar una 
Iterator iter, intinicio, int límite) cadena. 


int canDisplayUpTo(String str) Indica si esta fuente puede visualizar una 
cadena dada. 


GlyphVectorcreateGlypVector Obtiene un nuevo objeto Glyph Vector. 
(Font RenderContext frc, char[] 
chars) 


GlyphVector createGlypVector Obtiene un nuevo objeto Glyph Vector con 
(Font RenderContext frc, Cha- el carácter iterador dado. 
racterlterator ci) 


GlyphVector createGlypVector Obtiene un nuevo objeto GlyphVectorcon 
(Font RenderContext frc, int[] el array de enteros y FontRenderContext 
olyphcodes) dados. 


GlyphVector createGlyphVector Obtiene un nuevoobjeto GlyphVectorcrea- 
(Font RenderContext frc, String do con el FontRenderContext dado. 
sir) 


static Font decode(String str) Obtiene la fuente que describe la cadena. 


Font deriveFont(Affine Trans- Crea un nuevo objeto Font, duplicando el 

form trans) objeto Fontactual y aplicando una nueva 
transformación que convierte un conjunto 
de coordenadas en otras. 


Font deriveFont(ftoattamaño) Crea un nuevo objeto Font, duplicando el | 
objeto Font actual y aplicando un nuevo 
tamaño. 
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Método 


Font deriveFont(int estilo) 


Font deriveFont(intestilo, Affine 
y Transform trans) 


Font deriveFont(intestilo, float 
tamaño) 


Font deriveFont(Map atributos) 


boolean equals(Objectobj) 


protected void finalize() 
Map getAtributesO 


AtiributedaCharaciorniterator 
Attribute[] pal valable Ati- 
butesi) 


byte getBaselineFor(char c) 
String getFamily() 
String getFamily(Loca1e 1) 


static Font getFont(Map atri- 
butos) 


static Font getFont(String nm) 


static Font getFont(String nm, 
Fontfuente) 


String getFontName() 
String getFontName(Locate 1) 


Descripción 


Crea un nuevo objeto Fontduplicando el 
objeto Font actual y aplicando el nuevo 
estilo. 


Crea un nuevo objeto Font, duplicando el 
objeto Font actual aplicando un nuevo 
estilo y transformación. 


Crea un nuevo objeto Font, duplicando el | 
objeto Font actual y aplicando un nuevo 
estilo y tamaño. 


Crea un nuevo objeto Fontduplicando el 
objeto Font actual y aplicando un nuevo 
conjunto de atributos de fuentes. 


Compara este objeto Font con el objeto 
dado. 


Elimina el objeto Font nativo. 


Obtiene un mapa de los atributos de esta 
fuente. 


Obtiene las teclas de todos los atributos 
de la fuente. 


Obtiene la línea base para visualizar este 
carácter. 


Obtiene el nombre de la familia de esta 
fuente. 


Obtiene el nombre de la familia de esta 
fuente, localizada en el locale dado. 


Obtiene una fuente apropiada para los 
atributos. 


Obtiene un objeto Fontde la listadepropie- 
dades del sistema. 


Obtiene la fuente dada de la lista de pro- 
piedades del sistema. 


Obtiene el nombre de la fuente. 


Obtiene el nombre de la fuente localizada 
en el localedado. 


Metodo 


Descripción 


float getltalicAngel() 


LineMetrics getLineMetrics 
(chari] chars, int beginindex, 
int límite, FontRenderContextfrc) 


LineMetrics getLineMetrics 
(Characterlterator ci, intbegin- 
Index, intlímite, FontRender- 
Context frc) 


LineMetrics getLineMetrics 
(String str, FontRenderContext 
frc) 


RectangleZD getMaxChar 
Bounds(FontRenderContextfrc) 


intgetMissingGlyphCode() 


String getName() 
intgetNumGlyphs() 


java.awt.peer. FontPeerget- 
Peer() 


String getPSName() 
int getSize() 
float getSize2D() 


RectanglePDgetStringBounds 
(char[] chars, intbeginindex, 
intlímite, FontRenderContext 
frc) 


RectanglePDgetStringBounds 
(Characterlterator ci, int begin- 
Index, int límite, FontRender- 
Context frc) 


Obtiene el ángulo para el estilo cursiva de 
esta fuente. 


Obtiene un objeto LineMetrics,usando los 
argumentos dados. 


Obtiene un objeto LineMetricsusando los 
argumentos dados. 


Obtiene un objeto LineMetrics,creado con 
la cadena y el FontRenderContextdados. 


Obtiene los límites del carácter con los lí- 
mites máximos, como se definió en el 
FontRenderContextdado. 


Obtiene elcódigo glyph usado cuando es- 
ta fuente no tiene un glyph para un ca- 
rácter Unicode dado. 


Obtiene el nombre lógico de la fuente. 


Obtiene el número de glyphs de esta 
fuente. 


Obsoleto. Ahora se suponeque las fuentes 
son independientes de la plataforma. 


Obtiene el nombre Postscriptde la fuente. 
Obtiene el tamaño del punto de la fuente. 


Obtiene el tamaño del punto de esta fuente 
en un valor float. 


Obtiene las fronteras del array de carac- 
teres en FontRenderContext. 


Obtiene las fronteras de los caracteres en 
el iterador de carácter dado en FontRen- 
dercontext. 
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Método Descripción 


Rectangle2D getStringBounds Obtiene los límites de la cadena dada en 
(String str, FontRenderContext un FontRenderContext. 
frc) 


Rectangle2D getStringBounds Obtiene los límites de la cadena dada en 
(String str, int beginindex, un FontRenderContext. 

int límite, FontRenderContext 

frc) 


int getStyle() Obtiene el estilo de esta fuente. 


Affine Transform getTransform() Obtiene una copia de la transformación 
asociada con esta fuente. 


int hashCode() Obtiene un hashcode para esta fuente. 


boolean hasUniformLineMe- Verifica si esta fuente tiene líneas métricas 
trics() uniformes. 


boolean isBold() Indica si el estilo de este objeto Font es 
negrita. 


boolean isltalic() Indica si el estilo de este objeto Font es 
cursiva. 


boolean isPlain() Indica si el estilo de este objeto Font es 
plano. 


String toString() Convierte el objeto Font en una 
representación de tipo string. 


Tabla 9.12. Campo de la clase FontMetrics. 


Deseripel 


| protected Fontfuente Determina la fuente de la que se crean las 
métricas. 


Tabla 9.13. Métodos de la clase FontMetrics. 


Método Descripción 


int bytesWidth(byte[] datos, int Obtiene la anchura de avance total para 
off, int len) mostrar el array de bytes dado en esta 
fuente. 


int charsWidth(char[] datos, int Obtiene la anchura de avance total para 
off, int len) mostrar el array de caracteres dado en 
esta fuente. 


Método 


Descripeión 


int charWidth(char ch) 
intcharWidth(int ch) 


intgetAscent() 
intgetDescenat() 
Font getFont() 


intgetHeight() 


intgetLeading() 


LineMetrics getLineMetrics 
(char[] chars, intbeginindex, 
int límite, Graphics contexto) 


LineMetrics getLineMetrics 
(Characterlterator ci, intbegin- 
Index, int límite, Graphics con- 
texto) 


LineMetrics getLineMetrics 
(Strings str, Graphics contexto) 


LineMetrics getLineMetrics 
(String str, graphics int begin- 
Index, intlímite, Graphicscon- 
texto) 


intgetMaxAdvance0 


intgetMaxAscent() 


Rectangle2D geiMax Ghar- 
Bound (Graphalescomtexto) 


intgetMaxDecent() 


intgetMaxDescent() 


Obtiene la anchura de avance del carácter 
dado en esta fuente. 


Obtiene la anchura de avance del carácter 
dado en esta fuente. 


Indica la fuente ascendente de la fuente. 
Indica la fuente descendente de la fuente. 


Obtiene la fuente descrita por el objeto 
FontMetrics. 


Obtiene la altura estándar de una línea de 
texto en esta fuente. 


Indica el principal de la fuente. 


Obtieneel objeto LineMetrics para elarray 
de caracteres dado. 


Obtiene el objetoLineMetricspara el itera- 
dor de caracteres dado. 


Obtiene el objeto LineMetrics para la ca- 
dena dada. 


Obtiene el objeto LineMetrics para la ca- 
dena dada en el contexto dado. 


Obtiene la máxima anchura de avance de 
cada carácter de esta fuente. 


Indica el máximo ascendente de la fuente 
descrita por este objeto FontMetrics. 


Obtiene los límites del carácter con los 
límites máximos en el contexto de gráficos 
dado. 


Obsoleto. Reemplazado por getMaxDes- | 
cenat(). 


Indica el máximo descendente de la fuente 
descrita por este objeto FontMetrics. 
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Metodo 


RectangleZDgetStringBounds 
(char chars, int beginindex, 
intlímite, Graphics contexto) 


RectanglePDgetStringBounds 
(Characterlterator ci, int begin- 
Index, int límite, Graphics con- 
texto) 


RectanglePDgetStringBounds 
(String str, Graphics contexto) 


RectanglePDgetStringBounds 
(String str, int beginIndex, int 
límite, Graphics contexto) 

int[] get Widths() 

boolean hasUniformLineMetricsQ 


int string Width(String str) 


String toStringO 


Descripción 


Obtiene los límites del arrayde caracteres 
dado en el contexto gráfico. 


Obtiene los límites de los caracteres inde- 
xados en el iterador del carácter dado del 
contexto gráfico. 


Obtiene los límites de la cadena dada en 
el contexto gráfico. 


Obtiene los límites de la cadena dada en 
el contexto gráfico. 


Obtiene la anchura de avance de los 
primeros 256 caracteres de la fuente. 


Verifica sila fuente tiene líneas de métrica 
uniformes. 


Obtiene la anchura de avance total para 
mostrar la cadena dada de esta fuente. 


Obtiene los valores de este objeto FontMe- 
trics como una cadena. 


Veamos un ejemplo. En este caso, se permitirá al usuario escribir caracte- 


res y visualizarlos en la fuente 
determinando el tamaño de la 


Courier, concentrado todo en un applet, 
pantalla del texto, usando los métodos 


stringwidth y getHeight de la clase FontMetrics y la anchura y altura de la 
applet con el método getSize de la applet. Además se permitirá al usuario 
especificar el tamaño del texto, así como el estilo, cursiva o negrita, y esta- 
blecer un objeto Font acorde con ello. Para instalar la fuente, de forma que se 
pueda utilizar cuando se visualice texto, se usa el método setFont del objeto 


Graphics. Esta es la applet: 


import java.awt.*; 
import java.awt.event.*; 
import java.applet.Applet; 


public class fuentes extends Applet implementsActionListener, KeyListener 


String text = ""; 


Button boldbutton, italicbutton, largebutton; 
boolean bold = falce; 

boolean italic = faise; 

boolean large = faise; 


public void kitoO0 

( 
boldbutton = new Button ("Fuente en negrita"); 
italicbutton = new Button ("Fuenteen cursiva"); 
largebutton = new Button ("Fuente grande"); 


add (boldbutton); 
add (italicbutton); 
add (largebutton) ; 


public void actionPerformed (ActionEvent event) 


I 


if (event .getSource () == boldbutton) bold = !bold; 
if (event .getSource () == italicbutton) italic = !italic; 
if (event .getSource () == largebutton) large = !large; 


requestFocus():; 
repaint() 3 


public void paint (Graphics g) 
I 


String fontname = "Courier"; 
int type = Font.PLAIN; 

int size = 36; 

Font font; 


FontMetrics fm; 
if(b01ld) type = type | Font .BOLD; 
if(italic) type = type | Font .ITALIC; 


if (large) size = 72; 


font = new Font (fontname, type, size); 
g.setFont (font); 


int xloc = (getSize0.width - fm.stringWidth(text)) / 2; 
int yloc = (getSize0.height + fm.getHeight0) / 2; 


g.drawString(text, xloc, yloc); 


public void keyTypedíKeyEvent e) 


( 
text = text + e.getKeyChar (); 


repaint ():; 


public void keyPressed(KeyEvent e) (1l 
public void keyReleased(KeyEvent e) (1 
1 


El resultado se muestra en la figura 9.3. Cuando el usuario escribe texto, 
ese texto aparece centrado en la applet. Además, cuando se usan los botones 
fuente en negrita, fuente en cursiva y fuente grande, el texto aparece con los 
atributos correspondientes, que también se muestran en la figura 9.3. 

Ahora es el momento de ponerse a trabajar con imágenes, veámoslo en e7 
siguiente punto. 


| m, Agphri Vara Famien risa 


Fuente en negnta | Fuenteen curwa | Fuente grande | 


ggggg 


Figura 9.3. Usar fuentes. 


Usar imágenes 


-7 
El gran jefe dice, "En esta tentativa de reportaje que escribió para el 
periódico de la empresa..." "¿Sí?" Je pregunta. "¿Dónde están las fotogra- 
fías?", pregunta GJ. "Hmm", le dice, "parece que es un trabajo para la clase 


Image". 
En AWT, el soporte de las imágenes se hace con la clase Image, que s* 
deriva directamente de java.Eang. Object: 


EEN 


java. lang. Object 
ljava.awt.Image 


Los campos de la clase Image se encuentran en la tabla 9.14, su construc- 
tor en la tabla 9.15 y sus métodos en la tabla 9.16. 


Tabla 9.14. Campos de la clase Image. 


Descripc ión 


static int SCALE-AREA-AVERAGING Indica que se utiliza el algoritmo del 
área media para la escala de laima- 
gen. 


static int SCALE-DEFAULT Indica que se utiliza el algoritmo por 
defecto para la escala de la imagen. 


static int SCALE-FAST Indica que se ha elegido un algoritmo 
para la escala de imagen que da 
mayor prioridad a la velocidad de 
escalamiento. 


static int SCALEREPLICATE Indica que se usa el algoritmo de la 
clase ReplicateScaleFilter para la 
escala de imagen. 


static int SCALE-SMOOTH Indica que se ha elegido un algoritmo 
para la escala de imagen que da 
más prioridad a la suavidad de la | 
imagen. 


static Object UndefinedProperty En el caso de que no se definiera 
una propiedad para una imagen 
particular solicitada, se debería 
devolver el objeto UndefinedPro- 


perty. 


Tabla 9.15. Constructor de la clase Image. 


Constructor Descripción 


image) Crea un objeto Image. 


Tabla 9.16. Métodos de la clase Image. 


Método Descripción 


abstract void flush() Vacía todos los recursos utilizados 
por la imagen. 


Método Descripción 


abstract Graphics getGraphics() Crea un contexto gráfico para dibujar 
unaimagenpor detrás de la pantalla. 


abstract int getHeight(ImageObserver Indica la altura de la imagen. 
observer) 


abstract Object getProperty(String Obtiene una propiedad de esta ima- 
nombre, ImageObserver observer) gen por nombre. 


Image getScaledInstance(intanchura, Crea una versión a escala de esta 
intaltura, intindicaciones) imagen. 


abstract ImageProducergetSource() Obtiene el objeto que produce los 
pixels de la imagen. 


abstract int getWidth(ImageObserver Indica la anchura de la imagen. 


observer) 
————_—_—_—__—_—__—___ —— 


Para cargar una imagen en un applet, se puede usar el método get-magee 
la clase Applet: 


Image getImage (URL url) 
Image getImage (URL url, String nombre) 


Aquí, se puede especificar la URL del fichero de imagen que se qier?7 
leer, usando la clase URL. Se puede crear un objeto URL usando el construc- 
tor de la clase URL como sigue: URL(http://java.sun.com/product/jdk/1.2), 
como se verá más tarde en este libro. En este capítulo, usaremos los métodos 
getCodeBase y getDocumentBase de la clase Applet para obtener la URL de 
la applet, y utilizar la misma dirección para buscar el fichero de imagen. 

Este es un sencillo ejemplo que lee una imagen, image.jpg, y luego la 
visualiza. Para leer la imagen, se usa el método getlmage. Para dibujarla, 
utilizamos el método drawZmage de la clase Graphics. Para saber más de esta 
clase, ver la sección "Dibujar gráficos", más adelante en este capítulo. A 
continuación se indica la forma general que utilizaremos para drawlmage, 
que nos permite especificar el objeto imagen que se va a dibujar y su posición 
en la applet: 


boolean drawImage (1lmage img, int x, int y, ImageO0bserver observer) 


Observe que a drawlmage hay que pasarle un objeto que implemente la 


interfaz Image Observer. Los objetos ImageObserver permiten monitorizar el 
progreso de las operaciones de carga de imágenes, y las veremos más tarde en 
este capítulo. En la clase Applet, hay una implementación por defecto de esta 


interfaz y por ello, sólo utilizamos la palabra clave this como 
ImageObserver: 


import java.awt.*; 
import Java.applet.*; 


public class imagen extends Applet 
1 


image image; 


public void initoO 


( 


image = getImage (getDocumentBase (), "image.jpgn); 
) 
public void paint (Graphics g) 


1 
g.drawImage (image, 10, 10, this); 


1 


objeto 


El resultado se muestra en la figura 9.4, donde se puede ver la imagen 


cargada. Este ejemplo lo encontrará en el CD como imagen.java. 


Por supuesto, hay muchas más cosas que se pueden hacer con las imáge- 


nes. Por ejemplo, se pueden redimensionar (ver el siguiente punto). 


E tpm visas baag i laia 


Figura 9.4. Visualizar una imagen. 


Redimensionar imágenes 


El programador novato está trabajando en un programa de gráficos y 
necesita su ayuda. "Quiero que el usuario pueda redimensionar imágenes", 
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dice NP. "¿Cómo se hace?" "No hay problema", le dice. "Sólo hay qu? 
especificar la nueva altura y anchura de la imagen en el métododrawlmage". 

Para redimensionar una imagen, se puede usar esta versión del método 
drawlmage de la clase Graphics, sobrecargado, que permite especificar la 
anchura y la altura de una imagen: 


drawImage(Image img, int x, int y, int anchura, int altura, -mage-bserveg 
observer) 


Aquí hay un ejemplo. En estaapplet, sólo se necesita presionar el ratón e? 
un punto y soltarlo en otro; laappletdibujará la imagen que se vio en el punto 


anterior, redimensionada de forma que ocupe el rectángulo que se ha defini- 
do: 


import Java.awt.*; 

import Java.lang.Math; 
import jJava.awt.event.*; 
import Java.applet.Applet; 


public class resizer extends Applet implements MouseListener 
I 

Image image; 

boolean mouseUp = falce; 

Point start, end; 


public void hit () 

{ 
image = getImage (getDocument-ase-”)'"image.JpgM); 
addMouseListener (this); 


public void mousePressed (MouseEvent e) 


{ 
start = new Point (e.getX(), e.getY()); 


public void mouseReleased (MouseEvent e) 


( 


mouseup = true; 


end = new -oint (-ath.max(e.getXGtart.-), 
Math.max(e.getY0, start.-)); 
start = new Point (Math.min(e.getX0, Start.-), 


Math.min(e.getYO, start . y)) ; 


repaint () ; 


1 


public void mouseClicked (MouseEvent e) () 
public void mouseEntered (MouseEvent e) (1 
public void mouseExited (MouseEvent e) () 


public void paint (Graphics g) 
I 
if (mouseUp) { 
int width = end.x - start.-; 
int height = end.y - start.y; 
g.drawImageiimage, start.x, start-y, width, height, this); 
) 


El resultado de este código se muestra en la figura 9.5, donde se puede ver 
que se ha redimensionado la imagen mostrada en el punto anterior. 

Hemos utilizado algunas variaciones del método drawlmage, que forma 
parte de la clase Graphics. Ahora, es el momento de echar un vistazo a esta 
clase en sí misma y a todo lo que contiene (gran cantidad de métodos). 
Veamos el siguiente apartado para los detalles. 


FE; par Ar dr da 


IMAGES! 


Dibujar gráficos 


El gran jefe aparece envuelto en el humo del cigarro y dice, "El equipo de 
diseño tiene preparado un programa ganador que quiero que escriba". "¿De 
qué se trata?", le pregunta. "Permite al usuario dibujar rectas, rectángulos y 
óvalos, así como dibujo libre con el ratón", dice GJ. "Realmente es una 
bomba", le responde. 
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E I núcleo de los gráficos AWT está formado por la enorme clase ~ra ~hics? 
que se deriva directamente de java.lang.Object. El constructor de esta clase 
se encuentra en la tabla 9.17 y sus métodos en la 9.18. 


Tabla 9.17. Constructor de la clase Graphics. 


Constructor Descripción 
protected Graphics() Crea un nuevo objeto Graphics. 


Tabla 9.18. Métodos de la clase Graphics. 


Método 


Descripción 


abstract void clearRect(int x, int y, int 
anchura, intaltura) 


Limpia un rectángulo, rellenándolo 
con el color de fondo. 


abstract void clipRect(int x, int y, int 
anchura, intaltura) 


Intersecta la región actual cortada 
con el rectángulo. 


abstract void copyArea(int x, int y, int 
anchura, intaltura, int dx, int dy) 


Copia un área del componente a 
una región dada por dx y dy. 


abstract Graphics create() Creaun nuevo objetoGraphics,que 


es una copia de éste. 


Graphics create(intx, int y, intachura, Crea un nuevo objeto Graphicsba- 


intaltura) sado en éste, con una nueva área 
de traslación y de corte. 
abstract void dispose() Se deshace de estecontexto gráfico. 


void draw3Drect(int X, int y, intan- 
chura, intaltura, boolean raised) 


Visualiza un contorno resaltado de 
3D de un rectángulo. 


Visualiza el contorno de un arco de 
círculo o elipse. 


abstract void drawArc(int x, int y, int 
anchura, intaltura, int startAngle, int 
arcAngle) 


void drawBytes(byte[] data, int offset, 
int longitud, int x, int y) 


Visualiza el texto dado por el array 
de bytes. 


void drawChars(char[] data, int offset, 
int longitud, int x, int y) 


Visualiza el texto dado por el array 
de caracteres. 


abstract boolean drawlmage(1mage 
img, int x, int y, Color bgcolor, Image 
Observer observer) 


Muestra la parte de la imagen dada 
que está disponible. 


abstract boolean drawlmage(1mage 
img, int x, int y, ImageObserver ob- 
server) 


Muestra la parte de la imagen dada 
que está disponible. 


Método Descripción 


abstract boolean drawlmage(1mage Muestra la parte de la imagen que 
img, int x, int y, intanchura, intaltura, ha sido puesta en escala para que 
Colorbgcolor, ImageObserverobsen/er) quepa en el interior del rectángulo. 


abstract boolean drawlmage(1mage Muestra la parte de la imagen que 
img, int x, int y, intanchura, intaltura, ha sido puesta en escala para que 
ImageObserver observer) quepa en el interior del rectángulo. 


abstract boolean drawimage(1mage Muestra la parte de la imagen que 
img, int dxl, int dyl, int dx2, intdy2, está disponible, poniéndola en es- 
int sxl, int syl, int sx2, int sy2, Color cala para que quepa en el interior 
bgcolor, Imageobserver observer) del área dada. 


abstract boolean drawlmage(1mage Muestra la parte de la imagen que 
img, int dxl, int dyl, int dx2, int dy2, está disponible, poniéndola en es- 


int sxl, int syl, int sx2, int sy2, cala para que quepa en el interior 

Imageobserver observer) del área dada de la superficie de 
destino. 

abstract void drawLine(int xI, intyl, Muestra una recta, usando el color 

int x2, int y2) actual, entre los puntos (xl, yl) y 
(x2, y 2). 


abstract void drawOval(int x, int y, int Muestra el contorno de un óvalo. 
anchura, int altura) 


abstract void drawPolygon(int[IxPoints, Muestraun polígonocerrado definido 


int[] yPoints, int nfoints) por losarraysde coordenadas xe y. 
void drawPolygon(Polygon p) Muestra el contorno de un polígono 
definido por el objeto Polygon dado. 
abstract void drawPolyline(int[] Muestra una secuencia de líneas 
xPoints, int[] yfoints, int nPoints) unidas definidas por los arrays de 


coordenadas x e y. 


void drawRect(int x, int y, intanchura, Muestra el contorno de un rectán- 
intaltura) gulo dado. 


abstract void drawRoundRect(int x, i Muestra el contorno de un rectán- 
nt y, intanchura, intaltura, int arcwidth, gulo con las esquinas redondeadas. 
int arcHeight) 


abstract void drawString(Attributed Muestra el texto dado por el iterador 
Characterlterator iterator, int x, int y) especificado. 


abstract void drawString(String str, Muestra el texto dado por la cadena 
int x, int y) especificada. 
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Método 


| void fil/3Drect(intx, int y, int anchura, 


intaltura, boolean raised) 


abstract void fillArc(int x, int y, int 
anchura, intaltura, int startAngle, 
int arcAngle) 


abstract void fillOval(intx, int y, int 
anchura, intaltura) 


abstract void fillPolygon(int[] xPoints, 


int[] yPoints, int nPoints) 
void fillPolygon(Polygon p) 


abstract void fillRect(intx, int y, int 
anchura, intaltura) 


abstract void fillRoundRect(int x, int y, 


int anchura, intaltura, int arcwidth, 
int arcHeight) 


void finalize() 


| abstract Shape getClip() 


abstract Rectangle getClipBounds() 


Rectangle getClipBounds(Rectang1er) 


Rectangle getClipRect() 
abstract Color getColor() 


abstract Font getFont() 
FontMetrics getFontMetrics() 


abstract FontMetrics getFontMetrics 


(Font f) 


boolean hitClip(intx, int y, intanchura, 


intaltura) 


Descripción 


Pinta un rectángulo 3D resaltado, 
relleno con el color actual. 


Rellena un arco de círculo o elipse 
cubriendo el rectángulo dado. 


Rellena el contorno de un óvalo del 
rectángulo dado, con el color actual. 


Rellena un polígonocerrado definido 
por losarraysdecoordenadasxey. 


Rellena el polígono definido por el 
objeto Polygon con el color actual 
del contexto gráfico. 


Rellena el rectángulo dado. 


Rellena el rectángulo con las esqui- 
nas redondeadas. 


Gestiona la colección garbagede 
este contexto gráfico. 


Obtiene el área recortada. 


Obtiene el rectángulo que limita el 
área recortada. 


Obtiene el rectángulo que limita el 
área recortada. 


Obsoleto. Reemplazado porgetclip- 
Bounds(). 


Obtiene el color actual del contexto 
gráfico. 


Obtiene la fuente. 
Obtiene las métricas de la fuente. 


Obtiene las métricas de la fuente 
dada. 


Devuelve verdadero si el área rec- 
tangular intersecta al rectángulodel 
área recortada. 


Método Descripción 


abstract void setC/ip(intx, int y, inl Fija el área recortada actual al rec- 

achura, intaltura) tángulo dado por las coordenadas 
especificadas. 

abstract void seiClip(Shape clip) Devuelve el área recortada de forma 
arbitraria. 

abstract void setColor(Color c) Establece el color del contexto grá- 


fico al color dado. 


abstract void setFont(Font fuente) Establece la fuente del contexto 
gráfico a la fuente dada. 


abstract void setPaintMode() Establece el modo de pintar para 
sobrescribir el destino con el color 
actual de este contexto gráfico. 


abstract void se?XORMode(Cotorc1) Establece el modo de pintar a al- 
ternar entre el color actual de este 
contexto gráfico y el nuevo color 
dado, usando XOR. 


String toString() Obtiene un objeto tipo String para 
representar este objeto Graphics. 


abstract void translate(int x, int y) Traslada el origen del contexto grá- 
fico al punto (x, y). 


Aquí, vamos a utilizar la clase Graphics para crear el programa que el gran 
jefe quería, un programa de gráficos que permita al usuario dibujar rectas, 
óvalos, rectángulos, rectángulos redondeados y dibujo libre con el ratón, 
como se muestra en la figura 9.6. 


[Ce Tess diga liii 
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Figura 9.6. Dibujo libre con el ratón. 


443 


Este programa se llama dibujarejavaen el CD, y así es como funciona: e l 
usuario hace clic sobre un botón indicando qué clase de figura quiere dibujar, 
con lo que se activa un indicador booleano en el programa. Cuando después 
el usuario presiona el ratón en la superficie de dibujo, ésa ubicación se 
almacena como start, usando un objeto Point (que tiene dos miembros de 
datos: x e y). Cuando se suelta el ratón en una nueva posición, esta se 
almacena como end. Al soltar el ratón, también se vuelve a pintar el progra- 
ma, y el usuario puede seleccionar la figura a dibujar, una recta, óvalo, 
rectángulo o rectángulo redondeado, entre las posiciones start y end basándo- , 
se en el indicador boleano fijado al hacer clic sobre los botones. 

El dibujo libre con el ratón es diferente. En ese caso, se almacenan hastfl 
1.000 puntos sobre los que se mueve el ratón. En el momento de dibujar, 
basta con unir los puntos con líneas (observe que no se genera un evento de 
ratón por cada pixel sobre el que se mueve el ratón, por lo tanto es necesario 
dibujar líneas entre las distintas posiciones del ratón que Java comunica). 

Así es dibujar.java (echaremos un vistazo a las secciones de dibujos cofl 
más detalle en las siguiente páginas): 

import java.awt.*; 

import java.lang.Math; 

import java.awt.event.* ; 


import java.awt.Graphics; 
import java.applet.Applet; 


public class draw extends Applet irnplernentc -ctionListenersoucelistener” 
“ouseMotionListener( 
Button bDraw, bline, boval, bRect, b-ounded; 
Point dot [] = new Point [10001 ; 
Point start, end; 
int dots = 0; 


boolean mouseUp = false; 
boolean draw = false; 
boolean line = false; 
boolean oval = false; 
boolean rectangle = false; 
boolean rounded = false: 


public void inito0 
( 


bLine = new Button (*Dibujar rectas"); 


bOval = new ButtonímDibujaróvalos"); 


bRect = new Button ("Dibujar rectángulos"); 
bRounded = new Button ("Dibujarrectángulos redondeados"); 


bDraw = new ButtoníWDibujolibre"); 


add (bLine); 
add (bOval ; 
add (bRect) ; 
add (bRounded); 
add (bDraw):; 


public void mousePressed (MouseEvent e) 


I 


mouseUp = fal 
start = new Point (e.getX0, e.getY0); 


ce; 


public void mouseReleased (MouseEvent e) 


{ 
if 


(lineX 
end = new 


} else { 


} 


end = new Point (Math.max (e.getX0, start.~), 


Point (e.getX0, e.getY()); 


Math.max (e.getY0, start.y)); 


start = new Point (Math.min (e.getX0, start.~), 


Math.min(e.getY0, start.y)); 


mouseup = true; 


repaint (); 
1 
public 
I 
if (drawX 
dot [dots1 
dots++; 
repaint () 
l 
1 
public 
public void mouse 
public 
public 


void mouseDraggedíMouseEvent e) 


= new Point (e.getX0, e.getY()); 


> 


void mouseClicked (MouseEvent e) [) 


Entered (MouseEvent e) (1 


void mouseExited (MouseEvent e)(l 
void mouseMoved (MouseEvent e) () 
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public void paint (Graphics g) 
I 
if (mouseup) { 
int width = end.x - start.~; 
int height = end.y - start.y; 


if(line){ 

g.drawLine (start.x, start. 
1 
else if (oval) ( 

g.drawOval (start.x, start. 
1 
ls 


if (rectangle) 
g.drawRect (start.x, start. 
1 
else if (rounded)( 
g.drawRoundRect(start.x, 


1 
else if(draw)( 
for (int loop—index 


g.drawLine (dot [loop-index].“, dot [1loop-index].-“, 
dot[loop—index + 11 .x, dot [loop—index + 11.y) 


y, end.x, end.y); 


y, width, height); 


y, width, height) ; 


start.y, width, height, 


0; loop—index < dots 


public void action-erformed(ActionEvente) 


{ 
setFlagsFalse~); 


if (e.getSourcg) == bDraw)draw = true; 
if (e.getSourcq) == bline)line = true; 
if (e.getSourca) == bOval)oval = true; 


if (e.getSource ( 
if (e.getSource ( 
1 


void setE'lagsFalse() 

( 
rounded = false; 
line false; 
oval = false; 
rectangle false; 
draw = false; 


1 


bRect) rectangle = true; 
b-ounded) roundeœ true; 
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Así es dibujar.java. Ahora, veremos algunas de sus funciones de dibujo. 
Todas estas funciones, excepto la de dibujo libre, permiten dibujar una figura 
entre las posiciones start y end, que el usuario indica al arrastrar el ratón. 


Dibujar rectas 


Usando el objeto Graphics, se puede dibujar una recta entre los puntos 
(x 1, y 1) y (x2, y2) con el método drawline: 


drawLine (int xl, int yl, int x2, int y2); 
Asíes como aparecía en dibujar.java: 
g.drawLine (start.x, start.-“,end.x, end.y); 


Se puede ver el resultado de dibujar.java en la figura 9.7. 


:~~b$a<réii gba! _Dibularrectángulos | -ibu-atrecffinguivedondeados | ~ibujlbre | 


Figura 9.7. Dibujar una recta con el ratón. 


Dibujar óvalos 


Las elipses, incluyendo los círculos, se denominan óvalos en AWT, y se 
pueden dibujar con el método drawOval de la clase Graphics: 


drawOval (int x, int y, int width, int height); 

Asíes cómo se dibujan los óvalos cuando se ejecuta dibujar.java: 
int width = end.x - start.-; 

int height = end.y - start.y; 


g.drawOval (start.x, start.y, width, height); 


Se puede ver el resultado de dibujar.java, en la figura 9.8. 


Dibujar rectángulos 


Se pueden dibujar rectángulos utilizando el método drawRecr de la clase 
Graphics: 


draw-ect (intx, int y, int width, int height); 
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Así se hace en dibujar.java: 

int width = end.x - start.”; 

int height = end.y - start.y; 

g.drawRect (start.x, start.y, width, height); 


El resultado de dibujar'¡ava se muestra en la figura 9.9, 


Arda A dla ¡Lil 
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Figura 9.9. Dibujar un rectángulo con el ratón. 


Dibujar rectángulos redondeados 


Los rectángulos redondeados (es decir, rectángulos con las esquinas r p 
dondeadas) se pueden dibujar utilizando el método drawRoundRect de la 


clase Graphics: 
—ZY 
drawRoundRect (int x, int y, int width, int height, int arcwidth. int 
arcHeight); 


77 
A continuación, se especifican la anchura y la altura del arco, en pixels. 10 
cual especifica cuánto hay que redondear las esquinas. Así es como se crei UN 
rectángulo redondeado en dibujar.java: 


int width = end.x - start.-”v; 
int height = end.y - start.y: 
g.drawRoundRect (start.x, start.y, width, height, 10, 10); 


Se puede ver el resultado de dibujar-java en la figura 9.10. 


Topi Varas han lens 
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Figura 9.10. Dibujar un rectángulo redondeado con el ratón. 


Dibujo libre 


El dibujo libre con el ratón se puede hacer utilizando la clase AWT 
Graphics, pero hay que implementarlo en el código. Así es como se hizo en 
dibujar-javausando el método mouseDragged: una vez que se está seguro de 
que el usuario está dibujando libremente, comprobando que el indicador 
draw es verdadero, se salvan todas las posiciones del ratón en un array 
llamado dot[]al arrastrarlo: 


public void mouseDragged (MouseEvent e) 


{ 
if (draw){ 
dot [dotsl = new Pointíe.getX0, e.getYO0); 
dots++; 
repaint ();5; 


1 


Después, en el momento de dibujar la figura, se unen los puntos usando 
rectas, como sigue: 


foríint loop—index = 0; loop—index < dots - 1; loop-index++){ 
g.drawLineídot [loop-index] .x, dot [loop-index] .y, 
dot [loop-index + 11.x. dot[loop-index + 11.y); 


El resultado se muestra en la figura 9.6 (ya visto anteriormente). 
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Dibujar arcos 


Con el método drawArc de la clase Graphics se pueden dibujar arcos (st? 
especifica el ángulo en grados): 


drawArc (intx, int y, int width, int height, int startAngle, int arcAngle) T 


Dibujar polígonos 


Hay gran cantidad de formas de dibujar polígonos y rectas de múltiple? 
segmentos con AWT: 


drawPolygon(int[] xPoints, int[l y-oints,int n~oints); 
drawPolygon (Polygon p); 
drawpolyline (int[] xPoints, int[ 1 yPoints, int nr-oints) 


Establecer los modos de dibujo 


AWT también permite alternar entre dos modos de dibujo, modo directoy 
modo XOR. con estos métodos: 


setXORMode (Color cl); 
setPaintMode0; 


En el modo directo, cualquier cosa que se pinte sólo cubre lo que esm 
debajo, pero en modo XOR, lo que se dibuje será exclusivamente ORed con 
un color particular que ya está en la pantalla. Es muy útil, porque cuanfo se 
hace XOR A con B dos veces, B se almacena, lo que significa que se puede 
dibujar algo en la pantalla y después dibujarlo usando el modo XOIR. A 
continuación, se recupera cualquier cosa que estuviera originalmente En la 
pantalla. Por ejemplo, si se quiere permitir al usuario que estire, de armii 
interactiva, las figuras que dibuja en dibujar.java, se haría como sigut: ël 
usuario dibuja una figura; después, cuando mueve el ratón, se redibuja li 
figura usando el modo XOR para borrarla. A continuación se vuelve a diIWIJAI 
con su nuevo tamaño. 


Seleccionar colores 


"Mi trabajo con los gráficos ha sido un poco monótono", dice el progrp 
mador novato, "porque todo es de color negro". "Bien", le contesta, "puede 
seleccionar el color fácilmente". 


Ninguna lección sobre gráficos estaría completa sin hablar de los colores, 
que se gestionan con la clase Color de AWT. Los campos de esta clase se 
encuentran en la tabla 9.19, sus constructores en la tabla 9.20 y sus métodos 
en la 9.21. 

Por ejemplo, para crear un nuevo color, se pueden especificar los valores 
rojo, verde y azul (en el rango 0 a 255) al constructor de la clase Color, como 
sigue: 


Color C = new coloríred, green. blue); 


Además, hay libertad para fijar el nuevo color de dibujo, usando 
setForeground: 


ebForegrcand 


Ahora, las operaciones de dibujo tendrán lugar en el color que se especifi- 
que. Además se puede usar un color predefinido, como Color.blue, en este 
caso, donde se está fijando el color de fondo: 


De hecho, también se pueden rellenar figuras usando el color que se 
especifique con los métodos de Graphics, comofillArc, fillOval, etc. 


Tabla 9.19. Campos de la clase Color. 


Campo Descripcei ón 


static Color lightGray 
static Color magenta 
static Color orange 
static Color pink 
static Color red 
static Color white 


static Color yellow 


static Color black Color negro. 
static Color blue Color azul. 

static Color cyan Color cyan. 

static Color darkGray Color gris oscuro. 
static Color gray Color gris. 

static Color green Color verde. 


Color gris claro. 
Color magenta. 
Color naranja. 
Color rosa. 
Color rojo. 
Color blanco. 
Color amarillo. 
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Tabla 9.20. Constructores de la clase Color. 


Constructor 


Color(ColorSpace cspace, float[] 
components, float alpha) 


Color(ftoat r, float g, float b) 


Color(ftoat r, float g, float b, float a) 


Color(int rgb) 


| Color (int rgba, boolean hasalpha) 


Color(int r, intg, int b) 


| Color(int r, intg, int b, int a) 


Descripción 


Crea un color en el espacio suminis- | 
trado por ColorSpace. 


Crea un color opaco con los valores 
dados para rojo, verde y azul, en el 
rango 0.0a 1.0. 


Crea un color opaco con los valores 
dados para rojo, verde, azul y alfa, 
en el rango 0.0a 1.0. 


Crea un color opaco con el valor 
RGB combinado, que consiste en el 
valor rojo en los bits 16-23, el verde 
en 8-15 y el azul en los bits 0-7. 


Crea un color con el valor RGBA 
combinado, que consiste en el valor 
de alfa en los bits 24-31, rojo en los 
bits 16-23, el verde en 8-15 y el azul 
en los bits 0-7. 


Crea un color opaco con los valores 
rojo, azul yverde dados, en el rango 
O a 255. 


Crea un color opaco con los valores 
rojo, azul, verde y alfa dados, en el 
rango Oa 255. 


Tabla 9.21. Métodos de la clase Color. 


Descripción 


Color brighter() 


PainiContext createContext(Co1or- 
Model cm, rectangle r, RectanglePD 
rZd, AffineTranstorm xform, Rende- 
ring Hints hints) 


Color darker() 


| static Color decode(String nm) 


Hace una versión del color con más 
brillo. 


Crea y devuelve un contexto pära 
generar un modelo en color sólido. 


Hace una versión del color más 
oscura. 


Convierte una cadena en un entera 
y devuelve ese color. 


Método 


Descripción 


boolean equals(Object obj) 
intgetAlpha() 

intgetBlue() 

static Color getColor(String nm) 


static Color getColor(String nm, Color y) 


static ColorgetColor(String nm, int y 


float] getColorComponents(Color- 
Space cspace, float compArray) 


float[] getColorComponentsffloai] 
cornpArray) 


ColorSpacegetColorSpace() 


float] getComponents(ColorSpace 
cspace, float[] compArray) 


float[] getCornponentsífloat[] comp- 
Array) 


intgetGreen() 


static Color getHSBColor(f oat h, 
float s float b) 


intgetRed() 
int getRGB( 


float] getRGBColorCornponents 
(floa 1] comArray) 


Determina si otrocolor es igual a éste. 
Obtiene el valor alfa. 
Obtiene el valor azul. 


Busca un color en las propiedades 
del sistema. 


Busca un color en las propiedades 
del sistema. 


Busca un color en las propiedades 
del sistema. 


Obtiene un arrayde floatque con- 
tiene los componentes de color del 
objeto Color en el color space. 


Obtiene un arrayde float que con- 
tiene los componentes de color (no 
alfa) del objeto Color. 


Obtiene el color space del objeto 
Color. 


Obtiene un arrayde floatque con- 
tiene los componentes de color y 
alfa del objeto Color en el color 
space. 


Obtiene un arrayde float que con- 
tiene los componentes de color y 
alfa del objeto Color. 


Obtiene el valor verde. 


Crea un objeto Colorbasado en los 
valores HSB. 


Obtiene el valor rojo. 


Obtieneelvalor RGB que representa 
el color en el modelo de color por 
defecto. 


Obtiene un arrayde float que con- 
tiene los componentes de color (no 
alfa) del objeto Color en el color 
space. 
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Método 

foal ga AGACoIlOr Components 
(Most comárrar) 
intgetTransparency0O 
inthashCode() 

static int HSBTOFrgb(foat hue, float 
brightness) 

static float[| RGBtoHSB(intr, intg, 


intb, float[] hsvals) 


String toString() 


Usar Canvases 


Descripción 


Obtiene un array de float que con- 
tiene los componentes de color y 
alfa del objeto Color en el color 
space. 


Devuelve el modo de transparencia 
para este color. 


Calcula el hashcodeparaeste color. 


Convierte los componentes de un 
color dado por el modelo HSB al 
modelo RGB por defecto. 


Convierte los componentes de un 
color, dado según el modelo RGB, a 
un conjunto de valores equivalente 
según el modelo HSB. 


Obtiene una representación en ca- 
dena de este color. 


El componente canvas æ construye especialmente para soportar las opera-" 
ciones de gráficos. 

Como su nombre indica, proporciona un espacio en blanco para dibujar7 
usando el objeto Graphics que se le pasa al métodopaint. Este es el diagrama 
de herencia de la clase AWT Canvas: 


java.lang.Object 
Ijava.util.-vent-bject 
Ijava.awt.—-omponent 
Ijava.awt.Canvas 


Los constructores de esta clase se encuentran en la tabla 9.22 y sus méto- 
dos en la 9.23. 


Tabla 9.22. Constructores de la clase Canvas. 


Constructor 


Crea un nuevo canvas. 


Canvas) 


Canvas(GraphicsConfiguration Crea un nuevo canvas, dado un objeto 
config) GraphicsConfiguration. 


Tabla 9.23. Métodos de la clase Canvas. 


Método Desc ripción 
void adoNotifyi) Crea el compañero del canvas. 
void paint(Graphics g) Se le llama para volver a pintar el canvas. | 


Los canvases se usan normalmente para soportar una forma básica de 
animación, ya que se puede utilizar el método setLocation de la clase 
Component para mover un canvas (o cualquier otro componente). Aquí hay 
un applet que hace esto cuando se hace clic sobre ella: 

import Java.applet.Applet; 


import java.awt.*; 
import jJava.awt.event.*; 


public class canvas extends java.applet.Appletimplements MouseListener 


graphicscanvas gc; 
Button buttonl; 


public void hito 

I 
gc = new graphicsCanvas0; 
gc.setSize(100, 100); 
addigc) ; 
addMouseListener (this); 


} 


public void mousePressed (MouseEvent e) (1 


public void mouseClicked (MouseEvent e) 
{ 
for(int loop—index = 0; loop—index < 150; loop-index++){ 
gc.setLocation(loop~index,0); 
} 
1 
public void mouseReleased (MouseEvent e)() 
public void mouseEntered (MouseEvent e) () 
public void mouseExited (MouseEvent e)f) 


class graphicscanvas extends java.awt.Canvas 


public void paint (Graphics g) 
I 
g.drawOval(10, 50, 40, 40); 
g.drawLine(10, 50, 50, 90); 
g.drawLine(50, 50, 10, 90); 


} 


El resultado se muestra en la figura 9.11. Cuando se hace clic sobre 4 
applet, el canvas, que visualiza una figura pequeña, se mueve a la izquierda y 
luego hacia la derecha. 

Este ejemplo se encuentra en el CD como canvas.java. Observe que, como- 
al método paint de un canvas se le pasa un objeto Graphics, se puede usar 
cualquier método Graphics en un canvas. 


PAR E An 


ppal canoa 


Figura 9.11. Animación sencilla con un canvas. 


Usar la interfaz Imageobserver 


' 


El especialista en soporte de productos (ESP) aparece y dice tristemente, ' 
"Ha habido quejas de cómo su programa dibuja las imágenes que se descar- 
gan de la red Internet, primero sólo aparece parte de la imagen, y el resto, 
gradualmente”. "Así funciona la red Internet", le responde, sorprendido. "¿No 
se puede arreglar?", pregunta ESP. 

Para ver las imágenes que se cargan se pueden usar los métodos de li 
interfaz ImageObserver. Como vimos antes, es necesario indicar a la interfaz 
ImageObserver que se carga una imagen en un applet y especificar la 
implementación por defecto de esta interfaz. En este punto, crearemos nues- 
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tra propia implementación de esta interfaz. La interfaz ImageOhserver sólo 
tiene un método, imageupdate: 


boolean imageUpdate (image img, int infoflags, int x, int y, int width, 
int height) 


A este método se le llama cuando la información de una imagen, que está 
siendo cargada de forma asíncrona, está disponible. Estos son losf7ags que se 
pasan en infoflags en el método imageupdate: 


ABORT: Indica que una imagen que se estaba siguiendo fue abortada. 
ALLBITS: Indica que una imagen estática que fue dibujada previamente 
ya está completa. 


ERROR: Indica que una imagen que se estaba siguiendo ha producido 
un error. 


FRAMEBZTS: Indica que otro marco completo de una imagen está 
disponible para dibujarse. 

HEIGHT: Indica que la altura de la imagen base está disponible (y se 
puede leer del argumento height del método imageupdate). 
PROPERTIES: Indica que las propiedades de la imagen están disponi- 
bles. 

SOMEBITS: Indica que hay disponibles más pixels para dibujar la 
imagen. 

WIDTH: Indica que la anchura de la imagen base está disponible (y se 
puede leer del argumento width del método image Update). 


El método imageupdate devuelve verdadero si se necesitan actualizacio- 
nes; devuelve false si se ha recibido la información que se quiere. 

Este es un ejemplo. En este caso, se sobrescribe el método imageUpdate 
para llamar a repainr y visualizar una imagen, pero sólo cuando está total- 
mente cargada: 


irmport java.awt.*; 
import jJava.applet.*; 


public class i¡observer extends Applet 


1 


Image image; 


public void init() 


{ 
image = get~mage (getDocumentBace~)"image.jpgn); 


1 


public void paint (Graphics g) 


{ 
g.drawImage (image, 10, 10, this); 
1 


gublic boolean imsgeUpdate (Image img, int flags, int x, int y, int W, 


int h) 


1 
if ((flags 8 ALLBITS) != 0) ( 
repaint (x, y, W, h); 
1 
return (flags 8 ALLBITS) == 0; 


1 


El resultado se muestra en la figura 9.12, donde la imagen aparece una vez 
que ha sido totalmente cargada. Este ejemplo está en el CD como iobserver. java. 
Los programadores han comentado a Sun que la interfaz ImageObserver es 
demasiado compleja, especialmente cuando se trata de descargas múltiples. 
Por ello, Suncreó la clase MediaTracker (ver el siguiente apartado). 
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Figura 9.12. Usar la interfaz ImageObserver 


Usar la clase Media Tracker 


La clase MediaTracker proporciona una manera fácil (más fácil que utili- 
zar los objetos ImageObserver) para monitorizar la descarga de imágenes. 
Para empezar, sólo pasaremos al método addlmage, una imagen y un ID que 
se quiera utilizar para esa imagen (se puede usar el mismo ID que se utilice 
para enumerar las imágenes si se quieren controlar como si fueran un grupo): 


void addImage (lmage image, int id) 
void addImage (lmage image, int id, int w, int h) 


Con el método checkld se puede verificar si una imagen o grupo de 
imágenes han terminado de cargarse, como sigue: 


boolean checkIDíint id) 
boolean checkID(int id, boolean load) 


Este método devuelve Verdadero si la imagen o grupo de imágenes 
involucradas han terminado de cargarse; en caso contrario, devuelve False. 
Además se puede usar el método waitForAll; este método vuelve cuando 
todas las imágenes rastreadas están cargadas. 

Los campos de la clase MediaTracker se encuentran en la tabla 9.24, su 
constructor en la 9.25 y sus métodos en la tabla 9.26. 


Tabla 9.24. Campos de la clase Media Tracker. 


| Campos Descripción 


static int ABORTED Indica que la descarga se abortó. 

static int COMPLETE Indica que se completó la descarga del 
medio. 

static int ERRORED Indica que hubo un errorenladescarga 


de algún medio desarrollado. 


static int LOADING Indica que algún dato se está cargando 
actualmente. 


Tabla 9.25. Constructor de la clase Media Tracker. 


Constructor Descripción 


| A ; 
| MediaTracker(Componenfcomp) Crea un media fracker. 


Tabla 9.26. Métodos de la clase MediaTracker. 


Método Descripción 


void addlmage(1mageimage, int id) Añade una imagen a las imágenes que 
están siendo controladas. 


void addlmage(1mage image, int id, Añade una imagen a escala, a la lista 
int w, int h) de imágenes que están siendo contro- 
ladas. 


boolean checkAll(boolean load) Verificación para ver si todas las 
imágenes que se están siguiendo se 
han terminado de cargar. 
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Método 


boolean checkID(int id) 


boolean checkID(intid, boolean 
load) 


Object[] getErrorsAny() 

Object[] getErrorsID(int id) 
boolean isErrorAny() 

boolean isErrorlD(int id) 

void removelrnage(Image irnage) 
void removelrnage(1rnageimage, 
int id) 

void removelrnage(1mage irnage, 
int id, int anchura, int altura) 

int statusAll(boolean load) 

int statusiD(int id, boolean load) 
void waitForAll() 


boolean waitForAll(long rns) 
void waitForlD(int id) 


boolean waitForlD(int id, long ms) 


Descripción 


Verificación para ver si todas las imá- 
genes que se están siguiendo y que 
tienen el identificador dado, se han 
terminado de cargar. 


Verificación para ver sitodas las imá- | 
genes que se están siguiendo y que 
están etiquetadas con el identificador 
dado, se han terminado de cargar. 


Obtiene unalista de todas las imágenes 
que han dado un error. 


Obtiene una lista de las imágenes con 
el ID dado que han dado un error. 


Verifica el estado de error de todas las 
imágenes. 


Verifica el estado de error de todas las 
imágenes con el identificador dado. 


Elimina una imagen de este media 
tracker. 


Elimina la imagen dada con el ID es- 
pecificado. 


Elimina la imagenque tiene la anchura, 
altura e ID dados. 


Obtiene el desplazamiento de bits OR 
del estado de todos los media tracker. 


Obtiene el desplazamiento de bits OR 
del estado de todos los media tracker 
con el identificador dado. 


Inicia la carga de todas las imágenes. 
Inicia la carga de todas las imágenes. 


Inicia la carga de todas las imágenes 
del identificador dado. 


Inicia la carga de todas las imágenes 
del identificador dado. 


Veamos un ejemplo. En este caso, se usa el método waitForAll para 
esperar a que una imagen esté totalmente cargada (observe las sentencias try/ 


catch, que son las que gestionan las excepciones; las veremos con más detalle 
más adelante): 


import java.awt.*; 


import java.applet-*; 


public class mediatracker extends Applet 
I 


Image image; 


public void inito0 
( 


MediaTracker tracker 


= new MediaTracker (this); 
image = getImage (getDocumentBase-”), "image.jJpgW); 
trackor.sddinage (inege, 
try ( 
tracker.waitForAll (); 
1 
catch (InterruptedExceptionex) ( ) 
1 


public void paint (Graphics g) 
{ 
g.drawimage (image, 10, 


10, this); 
} 


El resultado se muestra en la figura 9.13. Este ejemplo está en el CD como 
mediatracker.java. 
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Figura 9.13. Usar el objeto Media Tracker. 


Trabajar pixel por pixel: Las clases PixelGrabber 
y MemorylmageSource 


"De acuerdo", dice el programador novato, "hay algunas cosas que quiero 
hacer gráficamente y sólo lo puedo hacer si tengo acceso directo a los pixels 
de la imagen. No sé utilizar Java para eso". "Por supuesto que sabe", le 
contesta. PN dice: "¡Explíqueme más cosas!" 

Para situar los pixels de una imagen en un array y acceder a los mismos, 
se pueden usar los objetos PixelGrabber. Este es el diagrama de herencia de 
PixelGrabber: 


java. lang.Object 
)java.awt.image.PixelGrabber 


Los constructores de esta clase se encuentran en la tabla 9.27 y sus méto- 
dos en la 9.28. 


Tabla 9.27. Constructores de la clase PixelGrabbers. 


Constructor Descripción 


PixelGrabber(1mageimg, int x, int y, Crea un objeto PixelGrabber para 
int w, int h, boolean forceRGB) coger la sección (X, y, w, h) de | 


pixels. 


PixelGrabber(1mageimg, int x, inty, Crea un objeto PixelGrabberpara 
int w, int h, int[] pix) coger la sección (x, y, w, h) de 
pixels y situarlos en un array de la | 
imagen dada. 


Tabla 9.28. Métodos de la clase PíxelGrabber. 


Método Descripción 
void abortGrabbingO Pide al objeto PixelGrabber qué 
aborte la imagen. 
ColorModelgetColorModel() Obtiene el modelo de color para las 
pixels en el array. 
int getHeight() Obtiene la altura del bufferde pixel. 
ObjectgetPixels() Obtiene el buffer de pixel. 
int getStatus() Obtiene el estado de los pixels. 
int get Width() Obtiene la anchura del buffer de 
pixels. 


Método Descripción 


boolean grabPixels() Solicita la imagen o el productor de 
imagen para empezar a entregarlos 
pixels. 

boolean grabPixels(1ong mS) Pide la imagen o el productor de 


imagen para empezara entregarlos 
pixels y espera a todos ellos, hasta 
que finalice el tiempo dado. 


voidimageComplete(intstatus) Parte del APIImageConsumer,que 
esta clase debe implementar para 
recuperar los pixels. 


voidsetColorModel(ColorModemodel) Parte del AP IlmageConsumer,que 
esta clase debe implementar para 
recuperar los pixels. 


void setDimensions(int width, intheight) Parte del APIImageconsumer, que 
esta clase debe implementar para 
recuperar los pixels. 


void setHints(int hints) Parte del APIImageConsumer, que 
esta clase debe implementar para 
recuperar los pixels. 


void setPixels(int srcX, int srcY, Parte del APIImageConsumer,que 
intsrcW, intsrcH, ColorModel model, esta clase debe implementar para 
bytel] pixels, int srcOff, intsrcScan) recuperar los pixels. 


void setPixels(int srcX, int srcY, Parte del APIImageConsumer,que 
intsrcw, intsrcH, ColorModel model, esta clase debe implementar para 
intl] pixels, int srcOff, int srcScan) recuperar los pixels. 


voidsetProperties(Hashtableprops) Parte del AP llmageConsumer, que 
esta clase debe implementar para 
recuperar los pixels. 


void stariGrabbing() Pide al objeto PixelGrabberqueem- 
piece a sacar los pixels. 


int status() Obsoleto. Reemplazado porgetsta- 
tus(). 


Para crear una imagen de un array de pixels, se puede usar la clase 
MemorylmageSource. El diagrama de herencia de esta clase es: 


java. lang.O0bject 
-java.awt.i¡mage.MemoryIlmageSource 
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Los constructores de la clase Mernorylmagesource se encuentran en la 
tabla 9.29 y sus métodos en la tabla 9.30. 


Tabla 9.29. Constructores de la clase MernorylmageSource. 


Constructor Descripción 


MemorylmageSource(int w, int h, Crea un objeto ImageProducerque 
ColorModel cm, byte[] pix, int off, int usa un array de bytes. 
scan) 


MemorylmageSource(int w,inth, Crea un objeto ImageProducerque 
ColorModel cm, bytel[] pix, int off, int usaunarraydebytes y propiedades. | 
scan, Hashtable props) 


MemorylmageSource(int w, int h, Crea un objeto ImageProducerque 
ColorModel cm, int[] pix, int off, int usa un array de enteros. 
scan) 


MemorylmageSource(int w,int h, Crea un objeto ImageProducerque 
ColorModel cm, byte[] pix, int off, usa un arrayde enteros y propieda- 
intscan, Hashtable props) des. 


MemorylmageSource(int w, inth, int[] Crea un objetolmageProducerque 
pix, int off, intscan) usa un array de enteros en el mo- 
delo de color RGB por defecto. 


MemorylmageSource(int w, inth, int[] Crea un objeto ImageProducerque 
pix, intoff, intscan, Hashtable props) usa unarraydeenterosen el modelo 
de color RGB por defecto y las 
propiedades. 


Tabla 9.30. Métodos de la clase MemorylmageSource. 


Metodo Descripcion 


void addConsumer(ImageConsumeric) Añade un objeto ImageConsumer 
a la lista de consumidores. 


boolean ¡sConsumer(ImageConsumer Indica si un objeto ImageConsumer 


ic) está en la lista de imágenes de con- 
sumidores. | 
void newPixels() Envíatodo un nuevo buffer de pixels 


a cualquier objetolmageConsumer. 


void newPixels(byte[] newpix, Color- Cambia a un nuevo arrayde bytes. 
Modelnewmodel, intoffset, intscansize) 


Método Descripción 


void nawPixelsjiinii] nawpix, Color- Cambiaa un nuevo arrayde enteros. 
Model newmodel, int offset, int scansize) 


void newPixels(int x, int y, int w, int h) Envía una región rectangular del 
buffer de pixels a los objetos 


ImageConsumer. 
void newPixels(int x, int y, int w, int h, Envía una región rectangular del 
boolean framenotify) bufferde pixels alos objetos Image- 
Consumer. 
void removeConsumer(1mageCon- Elimina un objeto ImageConsumer 
sumer ic) de la lista de consumidores. 
voidrequestTopDownLeftRightResend Solicita que los datos de la imagen 
(ImageConsumer ic) sean entregados de una vez , en 
orden de arribaaabajo yde izquierda 
a derecha. 


voidsetAnimated(boolean animated) Cambia la imagen en memoria a 
una animación o a un estado de 
imagen sencilla. 


voidsetFullBuferUpdates(boolean Indica si esta imagen animada de- 
fullbuffers) bería ser siempre actualizada en- 
viando el buffer completo de pixels. 


void startProduction(1mageConsumer Añade un objeto ImageConsumera 
ic) la lista de consumidores y empieza 
la entrega de datos de la imagen. 


Este es un ejemplo en el que se usan las clases PixelGrabber y Memorylma- 
gesource. En este caso, se lee una imagen y se copia en un nuevo objeto 
imagen. Esto se hace cargando la imagen que se ha utilizado en los ejemplos 
anteriores de este capítulo, que es de 485 por 88 pixels. Primero, se carga la 
imagen en image, se sitúan sus pixels en un array llamado pixels usando el 
método grabPixels del objeto PixelGrabber y luego se crea una nueva ima- 
gen, image2, usando el objeto MemoryImageSource y el método createlmage 
de la clase Applet: 

import Java.awt.*; 


import Java.applet.*; 
import java.awt.image.*; 


public class copiar extends Applet I 
Image image, image2; 


public void init () 

í 
image = getImage (getDocumentBase(), "image.jpg"); 
int pixels[l = new int[485 * 881; 


PixelGrabber pg = new ~ixelGrabber (image,0, 0, 485. 88, pixela, 
O, 485); 
trY { 
pg.grabPixels0; 
1 
catch (InterruptedExceptione) {1l 


for (int loop—index = 0; loop—index < 485 $ 88; loop-index++) | 


int p = pixelsCloop-indexl; 

int red = Oxff & (p >> 16); 

int green = Oxff 8 (p >> 8); 

int blue = Oxff 8 p; 

pixels[loop-index] = (Ox££000000 | red << 16 | green 13 g Í- 
blue); 


image2 = createlmage (new MemoryImageSource (485, 88, pixels, O, 


public void paint (Graphics g) 
I 
g.drawImage (image2, 10, 10, this); 


1 


Esto es todo lo que hay que ver aquí, ahora la imagen se ha copiado en 
image2 y se ha visualizado. Este ejemplo está en el CD como copiar .java. 
Ahora que tenemos acceso a los pixels de la imagen, haremos alguna cosa 
más con las imágenes, como el brillo, que veremos en el siguiente punito. 


Dar brillo a las imágenes 


Se puede dar brillo a las imágenes incrementando sus valores para el colo; 
rojo, verde y azul en la misma cantidad. En el siguiente código, sumaremos 
20 a cada valor de color: 


import java.awt.*; 
import jJava.applet.*; 


import java.awt.image.*; 


public class brillo extends Applet ( 
Image image, image2; 


public void initoO 

( 
image = getImage (getDocumentBase-), "image.jJpgV); 
int pixels[Íl = new int [485 * 881; 


PixelGrabber pg = new PixelGrabber (image, 0, 0, 485, 88, pixels, 
0, 485); 
try ( 
pg. grabpixels():; 
4 


catch (-nterruptedExceptione) {) 


for (int loop—index = 0; loop—index < 485 $ 88; loop-index++) (1 
int p = pixels[loop-index]; 
int red = (Oxff 8 (9 >> 16)) + 20; 
int green = (Oxff 8 (9>> 8)) + 20; 
int blue = (Oxff 8 p) + 20; 
if (red > 255) red = 255; 
if (green > 255) green = 255; 
if (blue > 255) blue = 255; 
pixels[loop-index] = (Ox££000000 | red << 16 | green << 8 | 


image2 = Ccreatelmage(new MemoryImageSOUrCe (485, 88, -ixels/ , 


public void paint (Graphics g) 


( 
g.drawImage (image2,10, 10, this); 


1 
1 


El resultado se muestra en la figura 9.14. Ahora, hemos manipulado las 
imágenes en el código. 


Convertir imágenes a escala de grises 


Se pueden convertir imágenes a grises haciendo la media de los valores 
rojo, verde y azul para cada pixel. En este caso, se convierte una imagen en 


color, whirl.gif (imagen blanca y roja que se verá más adelante, cuando7 
tratemos la animación de gráficos) a grises. Así es el código: 


import jJava.awt.*; 
import Java.applet.*; 
import Java.awt.image.*; 


AP} 


public class escaladegrises extends Applet { 
Image image, image2; 


public void inito0 

( 
image = getImage (getDocument~ase(),"whirll.gif"); 
int pixels[l = new intr248 * 2481; 


PixelGrabber pg = new PixelGrabber (image, 0, 0. 248, 248, pixels.1 
O, 248); 
try f 
pg.grabPixels0; 
1 
catch (InterruptedExceptione) (1 


for (int loop—index = 0; loop—index < 248 ü 248; loop-index++){ 
int p = pixels [loop-indexl 5 
int red = (Oxff P (p >> 16)); 
int green = (Oxff & (p >> 8)); 
int blue = (Oxff 6 p); 
int avg = (int) ((red + green + blue) / 3); 
pixels [loop-index] = (Oxff000000 | avg << 16 | avg << 8 | avg); 


— 

image2 = createlrnage(new MemoryImageSource(248, 248, pixeis, 0 
> 248)); 
> 


public void paint (Graphics g) 
g.drawImage (image2, 10, 10, this); 
1 


El resultado se muestra en la figura 9.15. Por supuesto, ver una imagen ena 
escala de grises en esta figura quizás no sea lo suficientemente convincente 


en un libro lleno de imágenes en blanco y negro. En su lugar, intente ejecutar 
el ejemplo del CD, es-aladegrises-java. 


[dape Va: bral olaa 
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Figura 9.14. Usar el objeto MediaTracker. 
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Figura 9.15. Convertir una imagen a grises. 


Realzar imágenes 


"Realzar" imágenes es un efecto potente en el que las imágenes aparecen 
elevadas de la superficie de visión; echaremos un vistazo a este efecto aquí. 
Este realce es más conveniente cuando se trabaja en términos de un array de 
dos dimensiones. Sin embargo, las clases PixelGrabbery MemorylmageSource 
sólo funcionan con arrays unidimensionales, por lo que, en este ejemplo, 
simularemos las dos dimensiones multiplicando y sumando los índices del 
array. A continuación, realzamos la imagen whirl.gifque vimos en el punto 
anterior: 


import java.awt.*; 
import java.awt.image.*; 
import java.applet.*; 


public class realzar extends Applet 


{ 


Image image, image2; 


public void hit () 

{ 
image = getImage (get-ocumentBase-)"whirll.gif"); 
int pixels[l = new int[248 * 2481; 


“ixelGrabberg = new PixelGrabber(image, O, 0, 248, 248, pixels, 


O, 248); 
try ( 
Ppg.grabPixels0; 
1 
catch (lnterruptedExceptione) {) 
for (intx = 2; x < 247; x++)( 
for (inty = 2; y < 247; y++)( 
int red = ((pixels[ (x+ 1) * 248 + y + 11 8 OXFF) - 
(pixels [x * 248 +y ] & OXxXFF)) + 128; 
int green = (((pixels[(x+ 1) * 248+y + 1182 0 ~ ~ ~ O 0x1p0) 
lx ixais[x * 248 + Y] E OXFFOO Ixl bl 0100] 
int blue = (((pixels[(x+ 1) * 248 + y + 118 
OXFF0000) / 0x10000) 8 0x100 - ((pixelS[x* 248 + y] 
F f 1001 133 
int avg = (red + green + blue) / 3; 
pixelsix * 248 + y] = (Ox££000000 | avg << 16 | avg c< 
8 | avg); 
1 
1 
image2 = createlmage (newMernoryImageSource (248, 248, pixels: 0 


public void paint (Graphics g) 
{ 
g.drawImage (image2, 0, 0, this); 


El resultado se muestra en la figura 9.16. Como se puede ver, la figura 
aparece resaltada. Este ejemplo está en el CD como realzar.java. 


Figura 9.16. Realzar una imagen. 


mMm awr: 
Ventanas, menús 
y cuadros 

de diálogo 


En este capítulo encontrará el siguiente paso para la construcción de 
controles en programas AWT. Crearemos y visualizaremos ventanas AWT y 
veremos todo lo que se va procesando, usando las clases de AWT Window y 
Frame. Echaremos un vistazo a cómo se usa la clase Dialog para crear 
cuadros de diálogo y la clase FileDialog para crear los cuadros de diálogo de 
archivos. También revisaremos los menús, ya que en la programación AWT 
se necesita una ventana antes de poder visualizarlos. Primeros veremos bre- 
vemente todos estos elementos. 


Ventanas 


Las ventanas, por supuesto, son la base de la programación GUI. Todo lo 
que hay que hacer con la interfaz de usuario en un entorno gráfico tiene lugar 
en una ventana, y todo usuario GUI está familiarizado con ellas. Para los 
programadores de AWT hay tres tipos de ventanas. 

El primer tipo es la ventana applet, en la que la clase Applet gestiona la 
ventana en sí misma y automáticamente la crea y la gestiona. Además, se 
pueden crear las ventanas frame, que son aquellas en las que se piensa 


Menús 


normalmente como ventanas, porque soportan un marco alrededor y un< 
barra de título, así como los botones de maximizar, minimizar y cerrar. Aquí 
crearemos una, usando la clase Frame. 


Hay otro tipo de ventana que se puede utilizar, la clase Window. Esta clase. 
sólo presenta una ventana en negro, sin barra de título, sin marco, sólo un 
rectángulo negro. Cada uno es responsable de visualizar lo que quiera en 
estas ventanas. Como se podría esperar, la clase Frame se deriva de la clase 
Window. Paradójicamente, sin embargo, en los programas no se puede crear, 
directamente, un objeto de tipo Window a menos que ya se tenga una ventana 
Frame, porque el constructor públicamente disponible de Window requiere 
que se le pase un objeto de tipo Frame o Window. 


Todo usuario GUI conoce los menús, son esos controles indispensables. 
que esconden todas las opciones de un programa y que las presentan por 
categorías. Imagine si todas las opciones de un procesador de texto que se 
pueden presentar estuvieran disponibles como botones, visibles todos a la 
vez; no habría espacio para escribir el texto. 

Los menús permiten almacenar esas opciones de forma compacta. Es una 
técnica GUI muy atractiva, porque el espacio es siempre un grado en los 
entornos de ventanas. 

En la programación AWT, se necesita una ventana frame para usar los 
menús. Con el método de ventana sefMenuBar se puede crear un objeto 
MenuBar y añadir esa barra de menú a una ventana frame. Además se crean 
objetos de la clase Menu para crear menús individuales (como Archivo, 
Edición, etc.). — 

Además, se pueden soportar algunas opciones agradables en los menú% 
submenús que se abren cuando se selecciona un elemento del menú y casillas 
de activación que le permiten activar o desactivar elementos del menú (como 
Revisar ortografía automáticamente o Mostrar barra de herramientas). Vere- 
mos todo esto en este capítulo. 


Cuadros de diálogo 


Los programas de ventanas utilizan, con frecuencia, cuadros de diálogo 
para que el usuario introduzca datos, como el nombre del archivo que se va a 
abrir, una clave o un color que se selecciona entre muchos otros. Al igual que 
otros elementos visuales de este capítulo, los cuadros de diálogo son familia- 
res para casi todos los usuarios GUI. Se usan cuando se quiere que el usuario 
introduzca información, pero no quiere visualizar un control dedicado, como 
un cuadro de texto, todas las veces en la ventana principal. Es decir, los 
cuadros de diálogo son ventanas temporales que se pueden rellenar con contro- 
les para la entrada de datos del usuario. 

En este capítulo, veremos dos tipos de cuadro de diálogo, soportados por 
las clases Dialog y FileDialog. Se usa la clase Dialog como una clase base 
para los cuadros de diálogo que se crean y personalizan. Por otro lado, 
generalmente no se necesita derivar una clase de la clase FileDialog, ésta 
presenta un cuadro de diálogo de archivos que el usuario puede utilizar para 
seleccionar un archivo. Los métodos y los miembros de datos de esta clase 
son suficientes para la mayoría de los propósitos de selección de archivos, y 
lo único que se necesita hacer es instanciar un objeto de esta clase y usarlo. 
También se verá esto en este capítulo. 

Hemos visto rápidamente de qué trata este capítulo. Hay mucho más que 
ver, por lo que pasaremos a la siguiente sección. 


Crear ventanas Frame 


"De acuerdo", dice el programador novato", estoy trabajando con mi 
procesador de textos de Java y quiero tener varias vistas del documento, cada 
una será una ventana situada en un lugar diferente del documento. ¿Qué 
opina?" Creo que debería pensar en permitir al usuario lanzar nuevas venta- 
nas frame”, le dice. 

Ya se ha visto la clase Frame en este libro, ya que se usa como base de la 
programación de aplicaciones en AWT. Este es el diagrama de herencia de las 
ventanas frame: 

java.lang.Object 

)java.util.EventObject 

Ijava.awt.Component 
lIjava.awt.Container 


Ijava.awt.Window 
(java.awt.Frame 
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Los constructores y métodos de esta clase se pueden ver en el capítulo 6, 
en las tablas 6.4 y 6.5, respectivamente. En los siguientes puntos, crearemos 
una ventana frame, que muestre y oculte lo que se necesite, dándole un 
tamaño, añadiéndole controles y gestionando los eventos. Para empezar, 
crearemos una nueva clase, ZabelFrame, basada en la clase Frame, y se 


visualizará una etiqueta con el texto "¡Hola desde Java! Esta es una ventana 
framel". 


Primero, declaramos esta nueva clase extendiendo la clase Frame: 
import jJava.awt.*; 


class labelFrame extends Frame 


c 


} 


A continuación, crearemos un constructor para la clase. Vamos a utilizar 
el constructor de la clase Frame, que da título a la ventana. Por lo tanto, 


añadiremos al constructor un parámetro para el título y lo pasaremos a la 
clase Frame, como sigue: 


import java.awt.*; 
class labelFrame extends Frame 


labelFrame (String title) 
( 
super (title); 


Aquí hay un punto importante, el layout manager por defecto para las 
ventanasframe es el gestor BorderLayout (a diferencia de las ventanasapplet, 
que usan el gestor FlowLayout). Observe que esto se aplica tanto a las 
ventanasframe que se visualizan desde las applets como a las ventanasframe 
que se usan en las ventanas de aplicación. Si se quiere utilizar un layout 
manager diferente, hay que instalarlo. En este caso, instalaremos el Jlow 
layout manager usando el método setlayout, como sigue: 


import java.awt.*:; 


class labelFrame extends Frame 


potLayoue [new FlowLayont i) ) j 


Ahora estamos preparados para crear una etiqueta y añadírsela al esque- 
ma: 


import java.awt.*; 


class labelFrame extends Frame 
{ 
Label label; 


labelFrame (Stringtitle) 

{ 

super (title); 

setLayout (new-lowLayout)) ; 


label = new Label ("iHola desde Java! Esta es una ventana frame."); 
acid (label); 
1 
1 


Esto completa la clase de ventanas frarne. El siguiente paso es visualizarla. 
Ver el siguiente punto para más detalles. 


Mostrar y ocultar ventanas 


"Hemos creado una clase de ventana frarne”, dice el programador novato. 
"Ahora, ¿cómo visualizamos una ventana de esa clase?" "No es difícil," le 


contesta, "después de dar un tamaño a la ventana, sólo hay que usar el método 
setVisiblel”. 


Esta es la clase de ventana frarne, ZabelFrarne, que se creó en el punto 
anterior: 


import Java.awt.*; 


class labelFrame extends Frame 


I 
Label label; 


label-rame (Stringtitle) 

( 

super (title); 
setLayout (new FlowLayout()) 5 


label = new Label ("¡Hola desde Java! Esta es una ventana frame.") ; 
add (label); 


1 


Lanzaremos esta ventana desde una applet. Para hacer eso, tendremos dos 


botones: Visualizar la ventana y ocultarla. Así es como se añaden estos 
botones a la applet: 


import jJava.awt.*; 
import jJava.awt.event.*; 
import jJava.applet.Applet; 


public class frame extends Applet implements ActionListener ( 


Button bl, b2; 


public void init () 
c 


bl = new Button ("Visualizar la ventana”) ; 
add (b1); 


bl.addActionListener (this); 


b2 = new B~tton (~0cultařła ventana"); 
add (b2); 


b2.addActionListener (this); 


1 
Ahora, crearemos un nuevo objeto de la clase labelFrame, dándole el 
título "Ventana Java": 


public class frame extends Applet implements ActionListener ( 


Button bl, b2; 
labelFrame window; 


public void init () 
1 


bl = new Button ("Visualizar la ventana"); 
ada (bl); 


b2 = new Button("Ocultar la ventana"); 
add (b2); 
b2.addActionListener (this); 


window = new labelFrame ("Ventana Javan); 


Antes de que se pueda visualizar una ventana, hay que darle una medida, 
usando el método setSize; de lo contrario, no aparecerá en la pantalla. Asíes 
cómo utilizamos setSize dándole las dimensiones 300 por 200 pixels: 


public class frame extends Applet implements ActionListener { 


Button bl, b2; 
labelFrame window; 


public void hitoO0 

1 
bl = new Button("Visualizar la ventana"); 
addíbl); 
bl.addActionListener (this); 


b2 = new Button("Ocultar la ventana"); 
add (b2); 
b2.addActionListener (this); 


window = new labelFrame ("VentanaJava"); 
window.setSize(300, 200); 


El nuevo objeto ventana ya está preparado. Para visualizar la ventana, se 
puede usar el método setvisible. Se le pasa un valor True y para ocultarla, el 
valor False. A continuación se indica el código para estos dos botones en la 
applet: 


public void actionPerformed(ActionEvent event) 


{ 


if (event .getSource0 == bl)i 
window.setVisible (true); 

1 

if (event .getSource() == b2){ 
window.eetVisible (false); 

1 


Esto es todo lo que se necesita. La applet ya está preparada, como se 
muestra en la figura 10.1. Cuando se hace clic sobre el botón Visualizar la 
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ventana, la ventana frame se muestra, con un luminoso aviso en el fondo de 
la misma (que no es visible cuando se usa una ventana frame en una aplica- 
ción), como se puede ver en la figura. Cuando se hace clic sobre el botón 
Ocultar la ventana, ésta desaparece de la pantalla. 


Wiauslzar la ventana | Desa la ventana | 


E Merino Lv lll 


Hua desa baes Eta aa uia bars Marne 


Figura 10.1. Visualizar una ventana frame. 


Gestionar eventos de ventana 
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"Hmm", dice el programador novato, "he puesto trescientos botones en" 
una ventana frame, pero cuando se hace clic sobre ellos, no pasa nada". Usted 
sonríe y le dice, "¿Ha gestionado los eventos de hacer clic sobre cada botón 
en su ventana?" "Uh-oh", dice PN. 

Los eventos en las ventanas se pueden gestionar de la misma forma que s 
gestionan en cualquier sitio, implementando los métodos de las interfaces 
listenero usando las clases adaptador. Vemos un ejemplo en el que gestiona- 
mos los eventos de ratón en la ventana frame desarrollada en los dos puntos 
anteriores, implementando los métodos en la interfaz MouseListener y luego, 
visualizando lo que el ratón hace con los mensajes en la etiqueta de esa 
ventana: 


class labelFrame extends Frame implements MouSeLi-tener 
Label label; 


labelFrame (String title) ( 
super (title); 
setLayout (new FlowLayoutoO); 


label = new Label (* ¡Hola desde Java! Esto es una ventana frame." 1i 
add (label); 


adios] stenar [this } 7 


public void mousePreesed (MouaeEvent e) 


if ((e.getMoclifiers() h InputEvent.BUTTOIO1-MASK) == 
InputEvent . BUTTON1-MASK) ( 
label.setTextí"Botón izquierdo del ratón pulsado en "+ 
e.getX() + KSS + e.getY0); 
1 
else{ 
label.setText ("Botón derecho del ratón pulsado en "+ e.getX0 
+ "=, + e.getY0); 
1 
1 


public void mouseClicked (MouseEvrnt e) 
( 

label .setText ("Pulsó el ratón en " + e.getX0 + iS s+ e.getY() ); 
1 


public void mouseReleased (MouseEvent e) 
( 

label.setText ("Se soltó el botón del ratón."); 
1 


public void mouseEntered (MouseE0ent e) 
I 
label.setText ("Ratón para introducir."); 


1 


public void mouseExited (MouseEvent e) 
( 
label.setText ("Ratón para salir."); 
1 
1 


El resultado se muestra en la figura 10.2. Como se puede ver, la ventana 
frame gestiona eventos MouseListener, visualizando mensajes. Este progra- 
ma se encuentra en el CD que acompaña a este libro, comoframe.java. 

Además hay eventos específicos para ventanas, es decir, hay toda una 


interfaz WindowListener. Sus métodos se pueden encontrar en la tabla 
10.1. 


Tabla 10.1. Métodos de la interfaz WindowListener. 


Métodos Descripción 


void windowActivated(WindowEvente) Se le llama cuando la ventana es 
la ventana activa del usuario, lo 
que quiere decir que la ventana 
recibirá los eventos de teclado. 
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Métodos Descripción 


void windowClosed(WindowEvente) Se le llama cuando una ventana | 
se cierra. 


void windowClosing(WindowEvente) Se le llama cuando el usuario 
cierra la ventana desde el menú 
del sistema de la ventana. 


void windowDeactivated(windowEvente) Se le llama cuando una ventana 
no es más grande que la ventana 
activa del usuario. 


void windowDeiconified(WindowEvente) Se le llama cuando una ventana 
se cambia de un estado 
minimizado a uno normal. 


void windowlconified(WindowEvente) Se le llama cuando una ventana 
se cambia desde un estado 
normal a uno minimizado. 


void windowOpened(WindowEvent e) Se le llama la primera vez que 
una ventana se hace visible. 


Figura 10.2. Gestionar eventos de ratón en una ventana frame. 
o 
Observe que la clase WindowAdapter se puede usar también para gestio- 
nar los eventos ventana. Esta clase ya implementa todos los métodos de la 
interfaz WindowListener y sólo se sobrescriben los métodos que se quieran 
usar. A los métodos de la interfaz WindowListener y de la clase WindowAdapter 
se les pasa un objeto de la clase WindowEvent. Los campos de esta clase Se 


pueden ver en la tabla 10.2, su constructor en la 10.3 y sus métodos en la 
10.4. 


En el siguiente punto, veremos uno de los métodos Windowlnterface 
trabajando junto con el evento windowCLosing. 


Tabla 10.2. Campos de la clase WindowEvent. 


static int WINDOW-ACTIVATED 
static int WINDOW-CLOSED 

static int WINDOW-CLOSING 
static int WINDOW-DEACTIVATED 
static int WINDOW-DEICONFIED 

| static int WINDOW-FIRST 


static int WINDOW-ICONFIED 
static int WINDOW-LAST 


static int WINDOW-OPENED 


Desc ripción ; ~ 
Evento "ventana activada". 
Evento "ventana cerrada". 
Evento "ventana cerrándose". 
Evento "ventana desactivada". 
Evento "ventana sin ¡conos". 


Primer número de ID dentro del ran- 
go usado para los eventos de venta- 
na. 


Evento "ventana iconificada". 


Últimonúmero de ID dentrodel rango 
usado para los eventos de ventana. 


Evento "ventana abierta". 


Tabla 10.3. Constructor de la clase WindowEvent. 


Constructor 


Descripción 


Windo wEvent(Window source. intid) Crea un objeto Windo wEvent. 


Tabla 10.4. Métodos de la clase WindowEvent. 


Metodo 


Descripción 


Window gelWindo w() 


String paramStringO Obtiene una cadena que identifique 
el evento. 


Ocultar ventanas automáticamente al cerrarlas 


Obtiene el originador del evento. 


"Hey", dice el programador novato, "otra vez Java está graciosillo. Cuan- 
do intento cerrar una ventana frame, no hace nada. Voy a enviar un correo a Sun 
Microsystems sobre esto, "En realidad", le dice, "está cerrando una ventana 
por usted, eso es todo”. "Oh, " dice PN, "¿cómo funciona eso?" 


Para cerrar una ventana frame cuando el usuario hace clic sobre el botón' 
Cerrar en la esquina superior derecha de la barra de título, se puede gestionar 
el evento windowClosing. Aquí, estamos usando una clase interna adaptador 
anónima para hacerlo (ver el capítulo 6 para más detalles). En este caso, sólo 
se esconde la ventana cuando el usuario hace clic sobre el botón Cerrar: 


class labelFrame extends Frame 
Label label; 


labelFrame (String title) 
I 
super (title); 
setlLayout (newFlowLayout-=); 
label = new Label ("iHoladesde Java! Esta es una ventana frame."); 
add (label) ; 
addMouseListeneríthis); 
addWindowListenerwindowAdapter() [publicvoidwindowClosing (“indowEvent 
e) (setVisible (false) ;)11: 
1 
1 


Hay algo útil que hacer notar. Cuando se cierra una ventana de esta formair 
todavía existe un objeto, lo que significa que todavía se puede acceder a sus 
métodos y miembros de datos. Esto será útil cuando vayamos a trabajar con 
cuadros de diálogo y se quieran recuperar los datos que el usuario metió. 


Usar la clase Window 
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"Quiero personalizar la apariencia de mi ventana totalmente", dice elT 
programador novato. "Voy a visualizar los trabajos de los grandes maestros 
de pintura y quiero hacer que el borde parezca un marco de un cuadro real”. 
"Hmm", le dice, "suena muy bien. Debería usar la clase Window y 
personalizarla". 

Para crear una ventana en negro preparada para personalizarse, se puede' 
usar la clase Window. Los constructores de esta clase se encuentran en la 
tabla 10.5 y sus métodos en la 10.6. 


Tabla 10.5. Constructores de la clase Window. 


Constructor Descripción 


window(Framepropietario) Crea una nueva ventana invisible. 


Window(Windowpropietario) Crea una ventana nueva invisible con 
la ventana dada como su dueño. 


Tabla 10.6. Métodos de la clase Window. 


Método Descripción 

void addNotify0 Hace que laventana sea visible, conectando 
la ventana al sistema operativo. 

voidaddWindowListener Añade el Windowlistenerdado para obtener 

(WindowListener ) los eventos de ventana desde la misma. 


voidapplyResourceBundle Aplica las propiedades del recurso dado a la 
(ResourceBunadle rb) ventana. 


voidapplyResourceBundle Carga el recurso con el nombre dado. 
(String roName) 


void dispose() Libera todos los recursosde pantalla nativos 
usados por esta ventana. 


protected void finalizeo Finaliza los métodos de entrada y contexto. 


ComponentgetFocusOwner() Obtiene el componentehijo de estaventana, 
que tiene el foco si y sólo si la ventana está 


activa. 

InpuiContextgetinpuiContext() Obtiene el contexto de entrada para esta 
ventana. 

Locate getLocale() Obtiene el objetolocaleasociado a esta ven- 


tana si el locale está puesto. 


Window[]getOwnedWindows()Devuelve un array que contiene todas las 
ventanas a las que esta ventana pertenece 


realmente. 
Window getOwner() Obtiene el propietario de esta ventana. 
Toolkit gettooIkit() Obtiene las herramientas del frame. 


StringgetWarningString() Obtiene la cadena de aviso visualizada con 
esta ventana. 


void hide() Esconde esta ventana. 
boolean isShowing() Verifica si esta ventana es visible. 
void pack() Hace que esta ventana sea medida para 


encajar la medida preferida y los esquemas 
de sus componentes. 


boolean postEvent(Evente) Obsoleto. Reemplazado por dispatchEvent- 
(AWTEvent). 


protected voidprocessEvent Procesa eventos en esta ventana. 
(AWTEvente) 


Método Descripción 


protected void processwin- Procesa los eventos de ventana que ocurren 
dowEvent(WindowEvente) en la misma, enviándolos atodos los objetos 
WindowListenerregistrados. 


voidremovewindowListener Elimina el window listener dado. 
(WindowListener 1) 


void setCursor(Cursor cursor) Establece que la apariencia del cursor sea la 
del cursor especificado. 


void show() Hace que la ventana sea visible. 
void toBack() Envía esta ventana a la parte de atrás. 
void toFront() Trae la ventana al frente. 


Veamos un ejemplo. En este caso, creamos una nueva clase de ventan; 
llamada 7abelWindow que visualiza una etiqueta con el texto "¡Hola desde 
Java!". Empecemos por declarar esta nueva clase: 


class labelwindow extends Window 
{ 


Tenemos que pasar un objeto Frame u otro objeto Window al constructor" 
de la clase Window. Para hacer las cosas más sencillas, usamos esta nueva 
ventana en una aplicación, por lo que pasaremos el objeto principal de la 
ventana frame al constructor de la clase labelwindow y luego ese objeto se le 
pasa al constructor de la clase Window, como sigue: 


class labelwindow extends Window ( 
Label label; 


labelWindow(AppFrame a£)( 
super (a£); 


Al igual que con las ventanas frame, el gestor de esquemas por defecto ef 
un border layout, por lo que instalaremos unflow layout y visualizaremos la 
etiqueta con su mensaje en la ventana: 


class labelwindow extends Window I 
Label label; 


labelwindow(AppFrameaf)f 
superíaf); 
set-ayout (newFlowLayout-”)); 
label = new Label ("lHola desde Java!"); 
add (label); 


Las ventanas de la clase Window son sencillamente negras con espacios 
blancos, por lo que además sobrescribiremos el métodopaint de esta ventana 
para añadir un frame muy sencillo, como un rectángulo. Observe que se 
pueden determinar las dimensiones de la ventana con el método getSize, al 
igual que en la applet: 


class labelwindow extends Window l 
Label label; 


labelwindow(AppFrameaf£)( 
super (af); 
setLayout (new FlowLayoutoO)'; 
label = new Label ("iHola desde Java!"); 
add (label) ; 


public void paint (Graphics g) 


{ 
int width = qetSize0.width; 


int height = getSize() .height; 


g- dArawRect (0, 0, —“ldth, -ħaigbE)} j 


Esto completa la clase ZabelWindow. Ahora, pondremos en funcionamien- 
to esta clase en una aplicación. En este caso, instanciaremos un objeto de la 
clase y fijaremos su tamaño, esto es necesario antes de que la ventana se 
pueda visualizar. Además pondremos su ubicación en la pantalla usando 
setlocation, porque actualmente no hay forma de mover la ventana cuando 
aparece, y si sólo se muestra con el método servisible, aparecerá en la posi- 
ción (0,0) de la pantalla, que está en el extremo de la esquina superior 
izquierda. Cuando el usuario hace clic en el botón Visualizar la ventana de 
esta aplicación, la ventana aparecerá. Cuando el usuario hace clic sobre el 
botón Esconder la ventana, ésta desaparecerá. Este es el código: 


import Java.awt.*; 
import java.awt.event.*; 
import java.applet.Applet; 


public class window 


{ 


public static void main(String [l args) 


AppFrame f = new AppFrameo0; 


f.addWindowListener (newWindowAdapterO ( public void 
windowClosing (WindowEvent e) (System.exit (0);))); 


class AppFrame extends Frame implements ActionListener 
( 

Button bl, b2; 

labelwindow window; 


ApprFrame() 
( 
setLayout (newFlowLayouto) ; 
bl = new Button("Visualizarla ventana"); 
add (b1) ; 
bl.addActionListener (this); 


b2 = new Button("Ocultarla ventana”); 
add (b2) ; 
b2.addActionListener (thic); 


window = new labellindow (this); 
window.setSize(300, 200); 
window.setLocation(300, 300); 

1 


public void actionPerformed (ActionEvent event) 


if (event.getSource0 == b1)( 
window.setVisible (true); 

1 

if (event .getSource0 == b2)I 
window.eetVisible (falee); 


1 


El resultado se muestra en la figura 10.3. Como se puede ver, la ventana 
aparece con un borde mínimo y la etiqueta de control que visualiza un mensa- 
je. Esta aplicación se puede encontrar en el CD como ventana.java. 
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Figura 10.3 Crear una ventana de la clase Window. 


Crear menús 


"De acuerdo", dice el programador novato, "he estado esperando para 
preguntarle esto". "Ah, jsí?", le dice. El programador novato pregunta, "¿cómo 
se crean los menús?" Se sienta y le dice, "Mejor tomemos un café". 

Se pueden añadir menús AWT a ventanas de la clase Frame usando tres 
clases AWT: MenuBar, Menu y Menultem. Aquí veremos los detalles de las 
tres. La primera que utilizaremos es la clase MenuBar, que añade una barra de 
menú a una ventana frame. Después de que se ha añadido una barra de menú 
a una ventana frame, se pueden añadir menús, como el menú Archivo o el 
menú Edición, a esa barra de menú usando la clase Menu. Finalmente, en el 
programa añadimos los elementos a los menús, usando la clase Menultem. 

Crearemos y usaremos menús en los siguientes puntos mientras desarro- 
llamos una applet llamada menu.java, que encontrará en el CD. Esta applet 
visualizará una ventana frame con un menú. Esta es la applet: 


import java.awt.*; 
import java.awt.event.*; 
import java.applet.Applet; 


*) 
<APPLET 
public class menu extends Applet implements ActionListener 


Button bl; 
frame menuwindow; 


public void hit () 

I 
bl = new Button ("Visualizar el menú de la ventana"); 
add (b1); 
bl.addActionListener (this); 


menuwindow = new frame ("MenÚs"); 
menuWindow.setSize(200, 200); 


public void action-erformed(-ction-vemwent) 
( 
if(event .getSource) == b1)( 
menu-indow.setVisible(true); 


class frame extends Frame implements ActionListener 
( 

Menu menu; 

MenuBar menubar; 

Menultem menuiteml, menuitem2, menuitem3; 


Label label: 


frame (String title) 
( 
super (title); 
label = new Label ("(Holadesde Java!"); 
setLayout (new GridLayoutíl. 1)); 
add (label); 
menubar = new MenuBaroO; 


menu = new Menu("Archiv0"); 


menuiteml = new MenuItem ("Elemento 1"); 
menu.add (menuiteml) ; 
menuiteml.addActionListener (this); 


menuitem2 = new Menultem("ElementO 2"); 
menu. add (menuitem2); 
menuitem2.addActionListener (this); 


menuitem3 = new Menultem("ElementO 3"); 
menu. add (menuitem3); 
menuitern3.addActionListener (this); 


renubár. 3 (mena! 


setMenuBar i| nenubsr 


addWindowListener (new WindowAdapterO (public void 
windowClosing (WindowEvent e) (setVisible(false);>1); 
1 


public void actionPerformed(ActionEvent event) 


if (event.getSource () == menuiteml) ( 
label.set-ext ("Eligióel elemento 1") ; 

) else if(event.getSource0 == menuitem2) ( 
label.setText ("Eligió el elemento 2"); 

) else if (event .getSource () == menuitem3) ( 
label.setText ("Eligióel elemento 3"); 


1 


En la figura 10.4 se muestra esta applet en funcionamiento. 

El menú de esta applet ocupa un lugar en la clase de la ventana Frame que 
hemos llamado frame. Desarrollaremos esta clase por medio de ejemplos a lo 
largo de los siguientes puntos. 


Figura 10.4. Crear una ventana de la clase Window. 


Crear un objeto MenuBar 


"Estoy preparado para crear un menú de sistema en mi ventana frame”, 
dice el programador novato. "¿Por dónde empiezo?" "Empiece creando un 
objeto MenuBar. Siéntese y le explicaré cómo", le contesta. 

Para crear una barra de menús en una ventana frame, se usa la clase 
MenuBar. Este es el diagrama de herencia de la clase MenuBar: 


El constructor de esta clase se encuentra en la tabla 10.7 y sus métodos en 
la 10.8. 


Tabla 10.7. Constructor de la clase MenuBar. 


Constructor Descripción 


MenuBar() Crea una nueva barra de menús. 


Tabla 10.8. Métodos de la clase MenuBar. 
Método Descripción 


Menu add(Menu m) Añade el menú dado a la barra de menú. 
void addNotify () Crea el compañero de la barra de menú. 
int countMenus() Obsoleto. Reemplazado por getMenuCount(). 


void deleteShortCut Borra el menú dado. 
(MenuShortCut S) 


Menu getHelpMenu0 Obtiene el menú de ayuda de la barra de menú. 
Menu geiMenu(int 1) Obtiene el menú dado. 


int getMenuCount() Obtiene el número de menús de la barra de 
rnenús. 


Menultem getshortcut- Obtiene lainstanciade Menultemasociadacon 
Menultem(MenuShorfcuts) el objeto MenuShortcutdado. 


void remove(intindice) Elimina el menú localizado en el índice dado de 
esta barra de menús. 


void remove(Menu- Elimina el componente dado de esta barra de 
Component m) menú. 


void removeNotify() Elimina el compaiiero de la barra de menú. 


void setHelpMenu Establece que el menú de ayuda del menú dado 
(Menu m) es el de esta barra de menú. 


Enumeration shortcuts() Obtiene una enumeración de todas las formas 
abreviadas para usar el teclado de los menús. 


A continuación encontrará cómo creamos una barra de menú en la ventana 
frame de la applet menu.java, construida en el punto "Crear menús” (observe 
que instalamos la barra de menú en la ventana frame con el método setfMenuBar 
de la clase Frame: 


class frame extends Frame implements -ctionListener 


{ 


MenuBar menubar; 
Label label; 


frame (~tringtitle) 


superítitle); 
label = new Label("iHola desde Java!"1; 
setLayout(new GridLayoutíl, 1)) 5; 


add (label) 5 
menubar = new MenuBar () 5 


setHenuBar (nanibar]; 


Con esto, se visualiza una barra de menús en negro y es el momento de 
añadir algunos menús. Para más detalles, ver el siguiente apartado. 


Crear objetos Menu 


"Bien", dice el programador novato, "me he dado cuenta de que después 
de crear una nueva barra de menús, está vacía. ¿Cómo puedo añadir menús?" 
"Es fácil", le dice, "sólo hay que usar la clase Menu”. 

Con la clase Menu, se crean los menús individuales de la barra de menús. 
Este es el diagrama de herencia de esta clase: 

java. lang.Object 

Ijava.awt.MenuComponent 


ljava.awt.Menultem 
ljava.awt.Menu 


Los constructores de la clase Menu se encuentran en la tabla 10.9 y sus 
métodos en la tabla 10.10. 


Tabla 10.9. Constructores de la clase Menu. 


Constructor Método 

Menu() Crea un menú nuevo. 

Menu Siring etiqueta) Creaun menú nuevo con la etiqueta 
dada. 


Menu(Stringetiqueta, boolean tearOff) Crea un nuevo menú con laetiqueta 
dada, indicando si el menú puede 
partirse. 


Tabla 10.10. Métodos de la clase Menu. 


Método Descripción 


Menultem add(Menuttem m) Añade el elemento de menú dado. 
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void add(Stringetiqueta) 

void addNotify() 

void addSeparator() 

int countltems() 

Menultem getltem(intindice) 

int getltemCount() 

void insert(Menuttemmenuitem, 
intindice) 

void insert(Stringetiqueta, intindice) 
void inseriSeparator(intindice) 
boolean isTearOff() 

String pararnString() 

void remove(intindice) 


void removeAll() 


void removeNotify() 


Descripción 


Añade un elemento a este menú, 
con la etiqueta dada. 


Crea el compañero del menú. 


Añade una línea o un guión de 
separación al menú, en la posición 
actual. 


Obsoleto. Reemplazado por getl 
temcount. 


Obtiene el elemento localizado en el 
índice dado. | 


Obtiene el numero de elementos. 


Inserta, en la posición dada, un ele- 
mento del menú. 


Inserta un elemento de menú con la 
etiqueta dada. 


Inserta un separador en la posición 
dada. 


Indica si este menú es un menú 
partido. 


Obtiene la cadena que representa 
el estado de este menú. 


Elimina el elemento del menú que 
se encuentra en la posición dada. 


Elimina todos los elementos de este 
menú. 


Elimina el compañero del menú. 


A continuación, se indica cómo se crea un menú Archivo en la applet 
menu.java y se añade a la barra de menú (observe que se nombra al menú 
simplemente pasando el nombre al constructor de la clase Menu): 


cC ~ ~ £rame extends Frame implements ActionListener 


{ 


Menu menu; 
MenuBar menubar; 
Label label; 


frame (String title) 
( 


superítitle); 

label = new Label ("¡Holadesde Java!"); 
setLayout (new GridLayout (1, 1)):; 

add (label) ; 

menubar = new MenuBaroO; 


menu = new menuinArchivo"); 


menubar add inenujl; 


getHenular (mer ar 


Crear objetos Menultem 


El programador novato regresa y dice, "Hey, he creado un nuevo menú. 
¿Cómo puedo añadir elementos a ese menú?" "No es tan difícil", le dice, 


"basta con usar la clase Menultem". 
Cada elemento de menú que se añade a un menú AWT es realmente un 


objeto de la clase Menultem. Este es el diagrama de herencia de esta clase: 


java.lang.0bject 
ljava.awt.MenuComponent 
java .awt .Menultem 


Los constructores de esta clase se encuentran en la tabla 10.11 y sus 
métodos en la 10.12. 


Tabla 10.11. Constructores de la clase Menultem. 


Constructor Descripci 


Meenultem() Crea un nuevo elemento de menú. | 


ETE 


Constructor 


Menultem(Stringetiqueta) 


Menuitem(Stringetiqueta, Menu- 


Shortcut S) 


Descripeión 


Crea un nuevo elemento con la etiqueta 
dada y sin posibilidad de activarlo dg 
forma abreviada con el teclado. 


Creaun nuevo elemento con una forma 
abreviadapara activarlocon el teclado. 


ii 


Tabla 10.12. Métodos de la clase Menultem. 


Método 


Descripción 


void addActionListener(ActionListener1) Añade el actionlistenenladopara 


void addNotify() 


void deleteShortcut() 


void disable() 

protected void disableEvents(1ong 
events ToDisable) 

void enable () 

void enable(booltean b) 

protected void enableEvents(tong 


events ToEnable) 
String getActionCommand() 


String getLabel() 


MenuShortcutgetShortcut() 


boolean isEnabled() 


recibir eventos de acción desde 
este elemento de menú. 


Crea el compañero del elemento 
de menú. 


Borracualquierobjeto MenuShort- 
cut asociado con este elemento 
de menú. 


Obsoleto. Reemplazado por set- 
Enabled(bootean). 


Deshabilita la entrega de eventos 
a este elemento de menú. 


Obsoleto. Reemplazado por set- 
Enabled(boo1ean). 


Obsoleto. Reemplazado por 
setEnabled(bootean). 


Habilita la entrega de eventos a 
este elemento de menú. 


Obtiene el nombre del comando 
del evento de acción que ha sido 
producido por este elemento de 
menú. 


Obtiene la etiqueta de este ele- 
mento de menú. 


Obtiene el objeto MenuShortcut 
asociado con este elemento de 
menú. 


Verifica si este elemento de menú 
está habilitado. 


Método 


String paramStringO 


protected void processEvent 
A WTEvent e) 


void removeActionListener 
(ActionListener 9 


void setActionCommand(String 
comando) 


voidsetEnabled(boo1eanb) 
void setLabel(Stringetiqueta) 


void seiShortcut(MenuShorítcut 9 


Descripción 


Obtiene la cadena de parámetros 
que representa el estado de este 
elemento de menú. 


Procesa eventos en este elemento 
de menú. 


Elimina el action listenerdado, 
por lo queno obtiene más eventos 
de acción de este elemento. 


Fija el nombre del comando del 
evento de acción que está activa- 
do por el elemento del menú. 


Fija si se puede elegir este ele- 
mento de menú. 


Laetiquetade este elemento esla 
etiqueta dada. 


Fija el objeto MenuShortcut aso- 
ciado con este elemento. 


Para añadir un elemento de menú a un menú, basta con crear un nuevo 
objeto Menultem, pasando al constructor Menultem el nombre del elemento 
nuevo y después usando el método add del objeto Menu para añadirlo a un 
menú. Este es un ejemplo en el que se añaden elementos al menú Archivo de 
la applet menu.java: 


class frame extends Frame implements ActionListener 


{ 


Menu menu; 
MenuBar menubar; 
MenuItem menuiteml, menuited, menuitemi; 


Label label: 


frame(String title) 


{ 


super (title); 

label = new Label ("iHoladesde Java!"); 
setLayout (new GridLayout (1, 1)); 

add (label); 

menubar = new MenuBarO; 


menu = new Menu ("Archivo"); 


menuiteml = new MenuItem ("Elemento 1"); 
menu .ada (menuiteml) 5 
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mnuitenl.addkicctionListeseritbia)/ 


menuitem2 = new Menultem("ElementoO 2"); 
menu. add (menuitem2) ; 
menuitem2 .addActionListener (this); 


menuitem3 = new Menultem ("Elemento 3"); 
menu. add (menuitem3) ; 


menuitem3.addAction-istener (this); 


menabar. add (mara) j 


cocMonuBar [ramiibDar | i 


Ahora lo que ocurre es que cuando estos elementos son pulsados no hacen"i 
nada. Para aprender a soportar los eventos de menús, ver el siguiente pun- 
to. 


Gestionar los eventos de menú 


El programador novato (PN) regresa y dice, "Bien, ya tengo todo el menB 
del sistema, pero hay un problema. Cuando se hace clic sobre los elementos 
del menú no pasa nada". "Eso es porque hay que añadir un action listener a 
cada uno de -1los"le dice riendo: "Oh", dice PN. 

Los action listeners para los elementos de menú se utilizan igual que co T 
los botones. Este es un ejemplo en el que se habilita la gestión de eventos de 
menú en la applet menu.java. 

En este caso, se indica qué elemento ha seleccionado el usuario: 
visualizando un mensaje en una etiqueta. Primero, se añade unaction listener 
a cada uno de los elementos: 


class frame extends Frame implements -ctionListener 
i 

Menu menu; 

MenuBar menubar; 

MenuItem menuiteml, menuitem2, menuitem3; 


Label label; 


frame (String title) 
{ 
super (title); 
label = new Label ("¡Hola desde Java!"); 
setLayout (new GridLayout (1, 1)); 
add (label); 
menubar = new MenuBaroO; 


menu = new Menu("Archivo”):; 


menuiteml = new Menultem("Elemento1"); 
menu .add (menuiteml); 
menuiteml.addActionListener (this); 


menuitem2 = new Menultem("Elemento2"); 
menu.add (menuitem2 ; 
menuitem2.addActionListener (thia); 


menuitem3 = new Menultem("Elemento 3"); 
menu. add (menuitem3); 
menuitem3 . addActionListener (this); 


addWindowListener (new WindowAdapterO (public void 
windowClosing (WindowEvent e) (setVisible(false);11); 


public void ectionPerformed (ActionEvent event) 


{ 


if (event .getSource() == menuiteml)C 
label.setText ("Eligió el elemento 1"); 
) else if(event.getSource0 == menuitem2) ( 
label .setText ("Eligió el elemento 2"); 
j else if(event.getSource0 == menuitem3) ( 
label.setText ("Eligió el elemento 3"); 
1 


Ahora, el usuario puede ejecutar la applet menu-java y verá los elementos 
que seleccionó, como se muestra en la figura 10.5. 

Aunque utilizamos el método getSource de la clase ActionEvent para de- 
terminar qué elemento de menú fue pulsado, también se puede dar a cada 
elemento un comando de acción con el método setActionCommand, como se 
hizo para los botones en el capítulo 6, y usar el método getActionCommand 
de la clase ActionEvent para leer el comando de acción. 


| m= E 


Eligin el elemento 2 


Figura 10.5. Crear y usar un menú del sistema. 


Más opciones de menú 


En los puntos anteriores, creamos una applet, menu-java, que examinaba 
la construcción básica de un menú de sistema. En los siguientes apartados, lo 
elaboraremos más e incluiremos separadores de menú, elementos 
deshabilitados, casillas de activación con elementos de menús y submenús, 
todo en una nueva applet llamada menu2.java. 

Asíes la nueva applet: 


import java.awt. id E 
import java.awt.event.*; 
import java.applet.Applet; 


public class menu2 extends Applet implements ActionListener 


E 
Button bl; 
frame menuwindow; 


public void hit () 
{ 


bl = new Button ("Visualizar el menú de la ventana"); 
add (b1); 

bl.addActionListener (this); 

menu~indow= new frame ("~enÚs"); 


menuWindow.setSize (200, 200) ; 


public void action~erformed (~ctionEversvent) 
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if(event .getSource() == bl) ( 


class frame extends Frame implements ActionListener 
{ 
Menu menu, submenu; 
MenuBar menubar; 
MenuItem menuiteml, menuitem2, menuitem4; 
MenuItem subiteml, subitem2, subitem3; 
CheckboxMenuItem menuitem3; 
Label label; 


frame (String title) 
{ 
super (title); 
label = new Label ("iHoladesde Java!"); 
setLayout (new GridLayout (1, 1)); 
add (label) ; 
menubar = new MenuBaroO; 
menu = new Menu("Archivo"); 


menuiteml = new Menultem("Elemento 1"); 
menu. add (menuiteml); 
menuiteml.addActionListener (this); 


menuitem2 = new Menultemí "Elemento 2"); 
menu . add (menuitem2); 
menuitem2.addActionListener (this); 


menuitem3 = new CheckboxMenultem("Elemento con casilla 
activación"); 
menuitem3.addActionListener (this); 
menu. add (menuitem3) ; 


submenu = new Menu ("Sub menús"); 

subiteml = new Menultem("Subelemento 1"); 
subitem2 = new MenultemínSubelemento 2”); 
subitem3 = new Menultem("Sub elemento 3"); 
subiteml.addActionListener (this); 
subitem2.addActionListeneríthis); 
subitem3.addActionListener (this); 
menuitem2.addActionListener (this) ; 
menuitem2.addActionListener (this); 
submenu. add (subiteml); 
submenu. add (subitem2); 
submenu. add (subitem3); 


de 


menuitem4 = new Menultem("Saiir"); 
menuitem4.addActionListener (this); 
menu. add (menuitem4); 


addWindowListener (new WindowAdapterO (public void 


windowClosing (WindowEvent e) (setVisible(false);))): 


public void actionPerformed(ActionEvent event) 


{ 


if (event .getSource0 == menuiteml)I 
label.setText ("Eligióel elemento 1"); 

l else if (event .getSource0 == menuitem2)I 
label.setText ("Eligióel elemento 2"); 

) else if (event .getSource () == menuitem3)]1 
label.setText ("Eligióel elemento 3"); 


public void itemStateChanged (ItemEvent event) 


if (event.getSourcel == menuitem3) 1 
if(((CheckboxMenultem) event .getIltemSelectable-))getStateo) 
label.setText ("Elelemento 3 está selecciona- 


do"); 
else 
label.setText ("Elelemento 3 no está seleccio 


nado") ; 


h i n g Applet Window 


Figura 10.6. Elaborar un menú de sistema. 


Esta applet se puede ver en la figura 10.6. Desarrollaremos varios nuevos 
aspectos de estaapplet, menu2.java, en los siguientes puntos, cuando veamos 
cómo se gestionan varias partes de su código. 


Añadir separadores de menú 


Los elementos de menú se pueden agrupar usando los separadores de 
menú, líneas finas horizontales que aparecen en los menús (ver la figura 


10.6). 


Añadir un separador de menú es fácil, sólo hay que usar el método 
addseparator, como sigue: 


frame (String title) 


I 


superítitle); 

label = new Label ("iHola desde Java!"); 
setLayout (new GridLayout (1, 1)); 

add (label); 

menubar = new MenuBarO; 

menu = new Menu("Archivo"); 


menuiteml = new Menultem("Elemento 1"); 
menuiteml.addActionListener (this); 
menu. add (menuiteml) ; 


menuitem2 = new Menultern ("Elemento 2"); 


menuitem2.addActionListener (this) ; 
menu. add (menuitem2) ; 


sa. addaparátozr ida 


Deshabilitar elementos de menú 


"Este maldito Johnson", dice el programador novato, "ya ha estado ensu- 
ciando mi programa otra vez, seleccionando elementos de menú que no 
debería, como la revisión ortográfica cuando el programa dibuja gráficos. 
¡Hizo que explotara mi programa delante del gran jefe!” "Hmm", le dice, 
"¿qué tal si se deshabilitan los elementos del menú cuando no son adecua- 
dos?" PN sonríe y dice, "¡Va a ver ese Johnson!" 


Cuando se deshabilita un elemento de menú, se visualiza en gris y no se" 
puede seleccionar ni hacer clic sobre él. Para deshabilitar un elemento de 
menú, se usa el método setEnabled de ese elemento, pasándole un valor de 


False. 
Por ejemplo, se puede deshabilitar el segundo elemento de menú en 


menu2.java cuando el usuario haga clic sobre él, como sigue: 


class frame extends Frame implements ActionListener 
{ 
Menu menu, submenu; 
MenuBar menubar; 
Label label; 
MenuItem menuiteml, menuitem2, rnenuiteml; 
MenuItem subiteml, subitem2, subitem3; 
CheckboxMenuItemmenuitem3; 


frame (String title) 
I 
super (title); 
label = new Label (";Hola desde Java!"); 
setLayout (new GridLayout (1, 1)); 
add (label); 
menubar = new MenuBaroO; 
menu = new Menu("Archivo"); 


menuiteml = new Menultem("Elemento 1") ; 
menuiteml.addActionListener (this); 
menu.add (menuiteml) ; 


menuitem2 = new Menultem ("Elemento 2"); 
menuitem2.addActionListener (this); 
menu. add (menuitem2); 


public void action-erformed(ActionEventevent) 
( 


if (event.getSource () == menuiteml) ( 
label.set-ext ("-ligkrá elemento 1"); 
} else i£ (event .getSource () == menuitem2) ( 


menuitem2.-etEnabled(falce); 
label.set-ext ("-ligk+d elemento 2"); 


1 


El resultado se muestra en la figura 10.7, donde se puede ver el element$ 
deshabilitado. > 

Ahora que el elemento está deshabilitado, el usuario no tiene forma de 
hacer clic sobre él hasta que no esté habilitado de nuevo. 


Figura 10.7. Deshabilitar un elemento de menú. 


Añadir marcas de activación a menús 


El especialista en soporte de productos regresa descontento. "Hay un 
problema en su nueva aplicación", dice, "porque el usuario no tiene forma de 
saber si la opción de menú "Traducción automática a alemán" está activada o 
no, y los resultados son bastante molestos". "Hmm", le dice, "supongo que 
puedo añadir una marca de activación a esa opción de menú para mostrar 
cuándo tiene efecto". 

Se pueden crear elementos de menú que visualizan marcas de activación 
junto a ellos para indicar que esas opciones específicas tienen efecto. Además 
se puede mantener hundida esa marca cuando el usuario la selecciona. Para 
soportar este tipo de marcas, usamos la clase CheckboxMenultem, que tiene 
el siguiente diagrama de herencia: 


java.lang.Object 
Ijava.awt.MenuComponent 
Ijava.awt.CheckboxMenultem 


Los constructores de CheckboxMenultem se encuentran en la tabla 10.13 y 
sus métodos en la 10.14. 


Tabla 10.13. Constructores de la clase CheckboxMenultem. 


Constructor Descripción 
> | 
CheckbosMHenultemnd Crea un elemento con casilla de | 
activación. 


CheckboxMenultem(Stringetiqueta) Crea un elemento con casilla de ac- 
tivación con la etiqueta dada. 


CheckboxMenultem(Stringetiqueta, Crea un elemento con casilla de 


booleanestado) activacióncon la etiqueta y el estado 
dados. 


Método 


void additemListener(TtemListener 1) 


void addNotify () 
Object[] getSelectedObjects() 


boolean getState() 

String paramString() 
protected void processEvent 
(AWTEvente) 

protected void processEvent 


(ltemEvent e) 


void removeltemListener(item- 
Listener 1) 


void seiState(boo1eanb) 


Tabla 10.14. Métodos de la clase CheckboxMenultem. 


Descripción 


Añade el ¡tem listener dado para 
recibirlos eventosde este elemento. 


Crea el compañerode ese elemento. 


Obtienen unarrayde longitud 1 que 
contiene la etiqueta del elemento. 


Determina si el estado de este 
elemento es activado o no. | 


Obtiene una cadena que representa 


el estado de este elemento. 
| 


Procesa eventos en este elemento. 


Procesa los eventos que ocurren en | 
este elementoenviándolosaobjetos 
ltemListener. 


Elimina el ¡tem listener dado para 
que no reciba más eventos de este 
elemento. 


Fija el elemento al estado dado. 


Observe que usamos item listeners, no action listeners, con este tipo de 
elementos de menús. Aquí vemos cómo se añade un elemento con casilla de 
activación en la applet menu2.java, usando un objeto ItemListener: 


class frame extends Frame implments ActionListener, 


Menu menu, submenu; 
MenuBar menubar; 
Label label; 


«“temtistener( 


Menultem menuiteml, menuitem2, menuitem4; 
Menultem subiteml, subitem2, subitem3; 


CheckboxMenultem menuitem3; 


frame (String title) 
I 
super (title); 
label = 


new Label ("iHoladesde Java!"); 


setLayout (new Grid-ayout (1,1)); 


add (label); 
menubar = new MenuBaroO; 
menu = 


menuiteml = 


new Menu("Archivo"); 


new Menultenm ("] 


Element01"); 


menuitem2 = new Menultem("Elemento2"); 


menuitem2.addActionListener (this); 
menu. add (menuitem2) ; 


menuitem2 = new Menultem ("Elemento con casilla de activación"); 


menuitem3.addItemListener (this); 
menu . add (menuitem3) ; 


addWindowListener (newWindowAdapterO (public void 
window-losing(WindowEvente) (setvisible(false);)-); 
1 
Cuando el usuario selecciona este elemento una vez tras otra, Java hunde 
la marca de activación o no, automáticamente. Para gestionar los eventos de 
este elemento, hay que sobrescribir el método itemStateChanged. En este 
caso, determinamos el estado del elemento y lo visualizamos en una etiqueta: 


(ItemEvent event) 


public void itemStateChanged 


I 
if (event.getSource(l1 == menuitem3)I 
if (((CheckboxMenultem) event .getItemSele-table-) .getStateo) 
label.setText ("El elemento 3 está seleccionado"); 


else 
label.setTe-t (-Eblemento 3 no está seleccionado") 


| Eligió el elemento 2 


ha: e Epi rias ; 


Figura 10.8. Usar un elemento con casilla de activación. 


En la figura 10.8 se puede ver un elemento de este tipo funcionando. 


mn 


Crear submenús 


Otro aspecto importante de trabajar con menús en la programación de 
AWT involucra a los submenús. Están unidos a un menú y cuando el usuario 
selecciona el elemento, el submenú se abre, como se puede ver en la figura 
10.9. El usuario puede seleccionar los elementos del submenú de la misma 
forma que lo hace en los menús normales. - 

Usar la técnica de los submenús es muy interesante cuando se necesita 
otro nivel de detalle; por ejemplo, quizás se quiera permitir que el usuario 
seleccione un color de dibujo con un elemento de menú, y cuando esté 
seleccionado, que un submenú se abra indicando los colores posibles, rojo, 
verde, magenta y azul. 

Crear un submenú es fácil, sólo hay que añadir elementos de menú a otro' 
elemento usando el método add. Este es un ejemplo que muestra cómo 
funciona. En este caso, se añaden los elementos de submenú que se ven en la 
figura 10.9 a los elementos de los submenú. Así sería el código: 


frame (Stringtitle) 
{ 
superititle); 
label = new Label ("iHola desde Java!"); 
setLayout (new ~ridLayout (1,1)); 
add (label) ; 
menubar = new MenuBarO; 
menu = new Menu("Archiv0"); 


menuiteml = new Menultem("Elemento 1"); 
menuiteml.add-ctionListener (this); 
menu.add (menuiteml); 


Figura 10.9. Usar submenús. 


menuitem2 = new Menultem("ElementO0 2"); 
menuitem2.add-ction-istener(this); 


menuitem3 = new CheckboxMenultem('Elemento con casilla de 
activación"); 
menuitern3.addActionListener (this) ; 
menu. add (menuitem3); 


submenu = new Menu ("Sub menús"); 

subiteml = new Men-“-Item(“Sublemento 1"); 
subitem2 = new Menultem("Sub elemento 2"); 
subitem3 = new Menultem("Sub elemento 3"); 
subiteml.add-ctionListener (this); 
subitem2.addActionListener (this); 
subitem3.addActionListener (this); 
menuitd.addActionListener(this); 
menuitd.addActionListener(this); 
submenu. add (subiteml) ; 
submenu . add (subitem2) ; 
submenu . add (subitem3) ; 


menuitem4 = new Menultem("Salir"» 
menuitem4.addActionListener (this) ; 
menu. add (menuitem4); 


menubar . add (menu) ; 
set-enuBar (menubar); 


) 


A continuación se puede ver cómo se gestiona el hacer clic sobre el 
elemento del submenú con el método actionPerformed: 


public void actionPerformed (ActionEvent event) 
{ 


if (event .getSource0 == menuiteml){ 
label.setText ("Eligiģl elemento 1"); 
) else if (event.getSource0 == menuitem2){ 


menuItem2.setEnabled (false); 
label.setText ("Eligióel elemento 2"); 


} else if(event.getSource0 == subiteml)Cc 
label.setText ("Eligió el sub elemento 1"); 
j else if (event .getSource() == subitem2)C 
label.eetText ("Eligió el sub elemento 2"); 
j else if (event .getSource() == subitem3)C 
label .set-ext ("Eligió el sub elemento 3"); 
j else if (event.getSource0 == menuitem4) ( 


setVisible (false); 


El submenú se muestra en la figura 10.9. Cuando el usuario selecciona” 
uno de los elementos del submenú, la applet visualiza el elemento que fue 
seleccionado en la etiqueta de la ventanaframe. 


Menús emergentes 


"Hey", dice el programador novato, "he visto que se puede hacer clic con 
el botón derecho sobre algunas aplicaciones y se visualiza un menú emergen- 
te. ¿Se puede hacer eso en Java?". "Claro", le contesta, "basta con usar la 
clase PopupMenu”. 

Se utiliza la clase PopupMenu para crear menús emergentes que no nece-y 
sitan estar unidos a una barra de menú. Este es el diagrama de herencia de 
esta clase: 


java.lang.Object 
Ijava.awt.MenuComponent 
ljava.awt.Menultem 
ljava.awt.Menu 
ljava.awt.PopupMenu 


Tabla 10.15. Constructores de la clase PopupMenu. 


Constructor Descripción 


Po~u~MenuO , Crea un nuevo menú emergente. 


PopupMenu(Stringetiqueta) Crea un nuevo menú emergente 
con el nombre dado. 


Tabla 10.1 6. Métodos de la clase PopupMenu. 
Descripción 


void addNotify() Crea el compañero del menú 
emergente. 


void show(Componentorigen, int s, int y) Muestra el menú emergente en 
la posición x, y. 


Los constructores de la clase PopupMenuse encuentran en la tabla 10.15 Y 
sus métodos en la tabla 10.16. 

Veamos un ejemplo. Aquí, creamos un nuevo menú emergente y le añadi- 
mos cuatro elementos (observe que además instalamos la interfaz 
MouseListener para gestionar los clics con el botón derecho): 


import Java.awt.*; 
import jJava.awt.event.*; 
import java.applet.Applet; 


public class menuemergente extends Applet implements ActionListener, 
MouselListener { 


Label label; 
PopupMenu popup; 
Menultem menuiteml, menuitem2, menuitem3, menuitem4; 


public void init() 

{ 
popup = new PopupMen~ (~t4enu~); 
menuiteml = new MenuItem ("Elemento 1"); 
menuiteml.addActionListener (this) ; 
menuitem2 = new Menultem("Elemento 2"); 
menuitem2.addActionListener (this); : 
menuitem3 = new Menultemí "Elemento 3"); 
menuitem3.addActionListener (this); 
menuiteml = new Menultem("Elemento 4"); 
menuitem4.addActionListener (this); 
popup . add (menuiteml)'; 
popup .addSeparatoroO; 
popup . add (menuitem2) ; 
popup .addSeparatoroO; 
popup . add (menuitem3) ; 
popup .addSeparator (); 
popup . add (menuitem4); 
add (popup) ; 
label = new Label ("iHola desde Java!"); 
add (label); 
addMouseListener (this); 


) 


Cuando el usuario hace clic con el botón derecho sobre la ventana de la 
applet, podemos utilizar el métodoshow de la clase PopupMenu para visualizar 
el menú, pasándole la palabra clave this que apunta a la applet y la posición 
en la que se visualizará el menú emergente (aquí, visualizamos el menú 
emergente en la posición en la que se hace clic con el ratón): 


public void mousePressed (MouseEvent e) 


I 
if (e.getModifiers0 != O)( 


Cuando el usuario hace clic sobre un elemento de un submenú, podemos 
visualizar dicho elemento con el método actionPerformed: 


public void actionPerformed (ActionEvent event) 
( 
if (event.getSource() == menuiteml) 
label .setText ("Eligió el elemento 1"); 
else if(event.getSource0 == menuitem2) 
label.setText ("Eligió el elemento 2"); 
else if(event.getSource() == menuitem3) 
label.setText ("Eligió el elemento 3"); 
else if(event.getSource() == menuitem4) 
label.setText ("Eligió el elemento 4"); 


Cuadros de diálogo 


qu 


"Uh-oh", dice el programador novato, "necesito que el usuario introduzca 
datos, pero el gran jefe dijo que si pongo más cuadros de texto en mi progra- 
ma, me arrepentiría". "¿Cuántos cuadros de texto tiene en su programa?”, ie 
pregunta. "Unos cuatrocientos", dice el programador novato. "Hmm", le dice, 
"bien, siempre se puede utilizar un cuadro de diálogo para obtener la entrada 
del usuario si no se quiere usar otro cuadro de texto". PN dice, "jestaPcii- 
do!”. 

El resultado se muestra en la figura 10.10. Como se puede ver en ella, el 
usuario puede abrir el menú emergente simplemente pulsando el botón dere- 
cho sobre la applet. Cuando el usuario selecciona un elemento del menú, la 
applet devuelve el elemento seleccionado. Este ejemplo está en el CD como 
menuemergente-java. 

AWT soporta una clase especial de ventana, la clase Dialog, que se puede 
utilizar para crear cuadros de diálogo. Las ventanas que se crean con esta 
clase se parecen más a los cuadros de diálogo estándar que los que se crean 
con las ventanas frame; por ejemplo, las ventanas de diálogo no tienen un 
botón Minimizar ni Maximizar. Este es el diagrama de herencia para la clase 
Dialog: 


Los constructores de la clase Dialog se encuentran en la tabla 10.17 y sus 
métodos en la tabla 10.18. 


Apiri 


Eligió el elemento 2 


Ihpplet staried. 
Figura 10.10. Usar menús emergentes. 
Tabla 10.17. Constructores de la clase Dialog. 


Constructor Descripción 


DialogíDialogpropietario) Crea un objeto Dialog inicial- 
mente invisible y no modal sin 
título y el cuadro de diálogo 
propietario. 


Dialog(Dia1ogpropietario, Stringtitulo) Crea un objeto Dialog, inicial- 
mente invisible y no modaicon 
el propietario y título dados. 


Dialog(Dialogpropietario, dialogtitulo, Crea un objeto Dialog, inicial- 
boolean modal) mente no visible con el propie- 
tario, título y modalidaddados. 


DialogíFramepropietario) Crea un objeto Dialog inicial- 
mente invisible, no modal sin 
título y el frame propietario 
dado. 


Dialog(Framepropietario, boolean modal) Crea un objeto Dialog inicial- 
mente invisible, sin título y con 
el frame propietario y modali- 
dad dados. 


Dialog(Framepropietario, String titulo) Crea un objeto Dialog inicial- 
mente invisible, no modal con 
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Constructor Descripción 


el título y el frame propietario 


dados. 
Dialog(Frame propietario, String titulo, Crea un objeto Dialog, inicial- 
boolean moda/) mente no visible con el propie- 


tario, título y modalidad dados. 
i 


Tabla 10.18. Métodos de la clase Dialog. 


Método Descripción 


void addNotify() Hace que este cuadro de diálogo sea vi- 
sualizable conectándolo a un compañero 
nativo. 

void dispose() Elimina el cuadro de diálogo. 

String getTittle() Obtiene el título del cuadro de diálogo. 

void hide() Oculta el cuadro de diálogo. 

boolean isModal() Indica si el cuadro de diálogo es modal. 

boolean ¡sResizable() Indica si el cuadro de diálogo puede ser 


redimensionado por el usuario. 


protected String paramString()  Obtienelacadenaque representaelesta- 
do de este cuadro de diálogo. 


void seiModal(boo1eanb) Especifica si este cuadro de diálogo 
debería ser modal. 
void setResizable(boo 1ean Indica si este cuadro de diálogo puede 
resizable) ser redimensionado por el usuario. 
| void setTittle(String titulo) Fija el título del cuadro de diálogo. | 


void show() Hace que el cuadro de diálogo seavisible. 


En estas tablas hay varias cosas que observar. Una es que se pueden crear 
cuadros de diálogo modales (es decir, que el usuario debe quitar el cuadro de 
diálogo de la pantalla antes de interactuar con el resto del programa) o 
cuadros de diálogo no modales, dependiendo del constructor Dialog que 
utilice o si se usa el método setModal. Otra puntualización es que se puede 
usar el método setResizeable para crear un cuadro de diálogo que el usuario 
pueda redimensionar. 

Veamos un ejemplo que pone a funcionar ala clase Dialog. Empezaremos 
creando una nueva clase cuadro de diálogo llamada okcanceldialog que 


visualiza un cuadro de texto y dos botones: Aceptar y Cancelar. Si el usuario 
escribe en el cuadro de texto y hace clic sobre el botón Aceptar, este texto 
aparecerá en la ventana principal de la aplicación; de lo contrario, si el 
usuario hace clic sobre el botón Cancelar, no aparecerá texto. Empezaremos 
por extender okcanceldialog de la clase Dialog, creando un nuevo cuadro de 
diálogo, y luego instalando los controles que se necesiten: 


class okcanceldialog extends Dialog implements ActionListener 
I 

Button ok, cancel; 

TextField text; 


okcanceldialog (Frame hostFrame, String title, boolean dModal) 
( 
super (hostFrame, title, Modal); 
setSize (300, 100); 
setLayout (new FlowLayout ()); 
ok = new Button ("Aceptarm) ; 
add (ok) > 
Ok.addActionListener ( (ActionListener) this); 
cancel = new Button ("Cancelarn); 
add (cancel); 
cancel .adBActionListener (this); 
text = new TextField(30); 
add (text) ; 
data = new String(""); 


1 


Cuando el usuario hace clic sobre el botón Aceptar, el texto que el usuario 
escribió se almacena en un miembro de datos público llamado data para que 
sea accesible para el resto del programa en el método actionPerformed. Si el 
usuario hace clic sobre Cancelar, en ese miembro de datos situamos una 
cadena vacía. Cuando el usuario hace clic sobre cualquier otro botón, escon- 
demos el cuadro de diálogo. Este es el código: 

class okcanceldialog extends Dialog implements ActionListener 

I 

Button ok, cancel; 


TextField text; 
public String data; 


public void actionPerformed (ActionEvent event) 


I 


if (event .getSource0 == ok) { 
data = text .getTextO0; 

1 else ( 
data = “5 


1 
setvisible (false); 
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Se puede utilizar la nueva clase okcanceldialog en una aplicación, 
visualizando un cuadro de diálogo de esa clase cuando el usuario selecciona 
la opción cuadro de diálogo del menú Archivo: 


import java.awt.*; 
import java.awt.event.*; 
import java.applet.Applet; 


public class dialog 


( 


public static void main(String [l1 args) 


dialogframe f = new dialogframe ("Diálogos"); 


f.addWindowListener(new WindowAdapteroO 
windowClosing (WindowEvent e) (System.exit (0);))); 


{public 


class dialogframe extends Frame implements ActionListener 


( 


Menu Menul; 

MenuBar Menubarl; 
Label label; 

MenuItem menuiteml; 
okcanceldialog dialog; 


dialogframe (String title) 


{ 


super (title); 

label = new Label ("¡Hola desde Java!"); 
setLayout (new GridLayout (1, 1)); 

add (label); 

Menubarl = new MenuBarO; 


Menul = new Menu ("Archiv0"); 


menuiteml = new Menultem("Cuadr0de diálogo.. 


Menul .add (menuiteml) ; 
rnenuiteml.add-ction-istener (thi”) 


“enubári. ada Meruli:; 


setMenuBar (Menubarl); 


0% 


dialog = new okcanceldialog(this, mDiálogom, true); 


m 


void 


public void actionPerforrned(ActionEvent event) 


{ 
if (event .getSource0 == menuiteml) ( 


dialog.setVisible (true); 
label .setText (dialog.data); 


1 


Observe que además se recuperan los datos del texto del cuadro de diálogo 
usando el miembro de datos público data y lo situamos en una etiqueta en la 
aplicación. Cuando esta aplicación se ejecuta y se hace clic sobre la opción 
Cuadro de diálogo... del menú Archivo, el cuadro de diálogo aparece, como 
se muestra en la figura 10.11. 

Cuando el usuario escribe texto en el cuadro de texto del cuadro de diálo- 
go y hace clic sobre Aceptar, el cuadro de diálogo se cierra y el texto aparece 
en la etiqueta de la ventana principal de la aplicación, como se muestra en la 
figura 10.12. 

Hay otro tipo de cuadro de diálogo, el archivo cuadro de diálogo, que 
veremos a continuación. 


| Fuie El ==" 3 


Figura 10.11. Visualizar un cuadro de diálogo. 


Ardmro 


„Este es el texto1 


Figura 10.12. Visualizar texto desde el cuadro de diálogo. 


Cuadros de diálogo de archivos 


Se puede usar la clase especial AWT FileDalog para crear y visualizar un 
cuadro de diálogo de archivos que permita al usuario visualizar directorios y 
seleccionar ficheros. Este es el diagrama de herencia para esta clase: 


java. Larg. Object 
| jaa at. Component 
—_JWA ARE. LOncALT1ar 
java. at indio 
java. awt.Dialog 
jara. aw. FilebDlalog 


Los campos de esta clase se encuentran en la tabla 10.19, sus constructo- 
res en la 10.20 y sus métodos en la 10.21. 


Tabla 10.19. Campos de la clase FileDialog. 


Descripción 


static int LOAD Indica que el propósito del cuadro de diálogo 
de archivos es localizar un archivo del que se 


pueda leer. 


static int SA VE Indica que el propósito del cuadro de diálogo 
de archivos es localizar un archivo en el que 
se -uedaescribir. 


== 


Tabla 10.20. Constructores de la clase FileDialog. 


Constructor Descripción 


FileDialog(Frarnepadre) Crea un cuadro de diálogo paraabrir un archivo. 


FileDialog(Framepadre, Crea un cuadro de diálogo con el título indicado 
String titulo) para abrir un archivo. 
FileDialog(Framepadre, Crea un cuadro de diálogo con el título indicado 


String titulo, int modo) para abrir o guardar un archivo. 


Tabla 10.21. Métodos de la clase FileDialog. 


Método ¿ Descripción 

void addNotify() Crea el compaiiero del cuadro de diá- 
logo. 

String getDirectory() Obtiene el directorio de este cuadro 
de diálogo. 

String getFile() Obtiene el archivo seleccionado de 


este cuadro de diálogo. 


FilenarneFiltergetFilenarneFilter() Determina el nombre de este cuadro 
de diálogo. 


int getMode() Indica si este cuadro de diálogo es 
para abrir un archivo o para guardarlo. 


protected String pararnString() Obtiene la cadena que representa el 
estado de este cuadro de diálogo. 


void setDirectory(String dir) Establece que el directorio de este 
cuadro de diálogo es el directoriodado. 


void setFile(String file) Establece que el archivo de este 
cuadro de diálogo es el archivo dado. 


void setFilenameFilter(Filename Establece que el nombre de este cua- 


Filter filter) dro de diálogo es el nombre indicado. 
voíd setMode(ínt rnode) Establece el modo del cuadro de 
diálogo. 


Este es un ejemplo en el que se permite al usuario visualizar los directo- 
rios por medio de un cuadro de diálogo. Cuando el usuario selecciona un 
archivo, se visualiza el nombre del mismo en la ventana principal de la 
aplicación. 

Hacer esto es fácil; basta con crear un objeto FileDialog, mostrarlo con el 
método setvisible, y luego leer el nombre del archivo que el usuario seleccio- 
nó con el método getFile: 


import java .awt.* 
import java.awt.event.* 


public class filedialog 
{ 
public static void main(String [] args) 


I 


Wi 
j = 
LO 


dialogframe f = new dialogframe ("Diálogos"); 


f.addWindowListener(new WindowAdapteroO 
windowClosing (WindowEvent e) (System.exit (0);)1);5 


Ipublic 


class dialogframe extends Frame implements ActionListener 


{ 


Menu Menul; 
MenuBar Menubarl; 
Label label; 
MenuItem menuiteml; 
FileDialog dialog; 


dialogframe (String title) 
{ 
super (title); 
label = new Label ("iHoladesde Java! "); 
setLayout (new GridLayout (1, 1)); 
add (label) 3 
Menubarl = new MenuBaroO; 


Menul = new Menu ("Archivo"); 


menuiteml = new Menultem("Abrirarchivo..."); 


Menul.add (menuiteml) ; 
menuiteml.add-ctionListener (this); 
H 


Menubarl.add [Mani 


setMenuBar (Menubarl); 


dialog = new FileDialog(this, nDiálogo archivo, true); 


1 


public void action-erformed (-“ctionEvenévent) 
I 
if (event .getSource () == menuiteml) lI 
dialog.setVisible(true); 


Haf. pet Texti"E giù + dial. ga 


void 


En la figura 10.13 se muestra el resultado en Windows (por lo tanto se usa 
un cuadro de diálogo de archivos de Windows). En esta figura, navegamos 
hasta un archivo. En la figura 10.14,hemos seleccionado un archivo y cerra- 
do el cuadro de diálogo, y la aplicación principal visualiza el archivo selec- 
cionado. 


Eligió archivo8 lava 


Figura 10.14. Leer el nombre de un archivo desde un cuadro de diálogo de 
archivos. 


EE] Swing: Applets, 


aplicaciones 
y cambios 
de apariencia 


Este capítulo inicia una sección del libro que muchos programadores 
estaban esperando, un debate sobre Swing. Demos antes un repaso a la histo- 
ria de Java. 


Clases Foundationde Java 


AWT era una herramienta poderosa que impulsó la popularidad de Java. 
Ahora Swing, que tiene aproximadamente cuatro veces el número de compo- 
nentes de la interfaz de usuario de AWT, es parte de la distribución estándar 
de Java y está tan de moda que ha llegado a desplazar a AWT. Sin embargo, 
AWT tuvo un avance significativo durante su existencia, aunque es, para los 
estándares de hoy, una implementación limitada, no diseñada para proporcio- 
nar una Ul seria y básica para las necesidades de millones de programadores. 
El conjunto de componentes AWT no fue diseñado para soportar la populari- 
dad con la que fue recibido y dentro de las necesidades de programación de 
hoy, está limitado en el rango, tiene muchos bugs y consume gran cantidad de 
recursos del sistema. 

Como se mencionó anteriormente en este libro, el AWT original se tardó 
en escribir sólo seis semanas, fue modelado con controles HTML y asignada 


Swing 


una ventana del sistema operativo por componente. Dado que los programa- 
dores llegaban a utilizar gran cantidad de controles, los colaboradores empe- 
zaron a producir sus propios conjuntos de controles, lo que hizo que en Sun 
Microsystems se pusieran nerviosos. Cuando Netscape introdujo su librería 
de clases Znternet Foundation Classes para usar con Java, éstas fueron muy 
populares, Sun decidió actuar y la unión de los esfuerzos de Sun y Netscape 
dio lugar al conjunto de componentes Swing como parte de las clases 
Foundation de Java (JFC). 

Muchos programadores creen que JFC y Swing son lo mismo, pero no es 
así; JFC contiene Swing y otro gran número de elementos. Esto es lo que hay 
en JFC: 


e Swing: El gran paquete UI. 


e Cortar y pegar: Soporte de portapapeles. 


Accesibilidad: Ayuda a los usuarios con aquello que no es posible hacer. 
e Colores del escritorio: Primero se introdujo en Java 1.1. 
e Java 2D: Soporte mejorado del color, imagen y texto. 


e Impresión: Originalmente disponible en Java 1.1. 


Swing introdujo tres avances significativos: utiliza pocos recursos del 
sistema, añade gran cantidad de componentes más sofisticados y permite 
construir la apariencia de los programas. A continuación, veremos Swing con 
más detalle. 


Swing es un conjunto de paquetes construido en la parte más alta de AWT 
que proporciona un gran número de clases preconstruidas (aproximadamente 
250 clases y 40 componentes UI). Desde el punto de vista del programador, 
los componentes Ul son probablemente los más interesantes, y losenumeremos 
aquí (observe que cada componente Ul empieza con J, que es una de las 
razones por la que muchos programadores usan erróneamente los términos 
JFC y Swing intercambiándolos): 


e JApplet: Versión extendida dejava.applet.Applet que añade el soporte 
para los paneles base y otros paneles. 


e JButton: Pulsador o comando de botón. 


JCheckBox: Casilla de activación que puede ser seleccionada o 
deseleccionada, de forma que visualmente se pueda saber su estado. 


JColorChooser: Panel de controles que permite al usuario seleccionar 
un color. 


JComboBox: Cuadro de lista desplegable, que es una combinación de 
cuadro de texto y lista desplegable. 


JComponent: Clase base para los componentes Swing. 


JDesktopPane: Contenedor usado para crear una interfaz de documen- 
tos múltiples o un escritorio. 


JDialog: Clase base para crear un cuadro de diálogo. 


JEditorPane: Componente de texto que permite al usuario editar varios 
tipos de contenido. 


JFiEechooser: Permite al usuario elegir un archivo. 


JFrame: Una versión extendida de java.awt.Frame que añade soporte 
para los paneles base y otros paneles. 


JinternalFrame: Un objeto de peso ligero que proporciona muchas de 
las características de un frame peso pesado. 


JinternalFrame.JDesktoplcon: Representa una versión iconificada de 
un JInternalFrame. 


JLabel: Área visualizable para una cadena de texto corta o una imagen 
(o ambos). 


JLayeredPane: Añade capas a un contenedor Swing, permitiendo que 
los componentes se solapen unos con otros. 


JList: Componente que permite al usuario seleccionar uno o más obje- 
tos de una lista. 


JMenu: Un menú de lista desplegable que contiene Jmenultems, que se 
visualiza cuando el usuario lo selecciona en el componente JMenuBar. 


JMenuBar: Una implementación de una barra de menú. 
JMenultem: Una implementación de una opción de menú. 


JOptionPane: Facilita la posibilidad de que emerja un cuadro de diálo- 
go estándar. 


JPanel: Un contenedor genérico peso ligero. 


JPasswordField: Permite editar una línea simple de texto donde no 
muestra los caracteres originales. 


JPopupMenu: Un menú emergente. 
JPopupMenu.Separator: Separador de un menú específico emergente. 


JProgressBar: Componente que visualiza un valor entero en un interva- 
lo. 


JRadioButton: Botón de opción que puede ser seleccionado o no, 
marcando su estado visualmente. 


JRadioButtonMenuZtern: Botón de opción de un elemento de menú. 
JRootPane: Componente fundamental de la jerarquía del contenedor. 
JScrollBar: Implementación de una barra de desplazamiento. 


JScrollPane: Contenedor que gestiona barras de desplazamiento verti- 
cales y horizontales y las cabeceras de filas y columnas. 


JSeparator: Separador de menú. 


JSlider: Componente que permite al usuario seleccionar un valor desli- 
zando un botón en un intervalo. 


JSplitPane: Divide dos componentes. 


JTabbedPane: Permite al usuario cambiar entre un grupo de componen- 
tes haciendo clic sobre lengiietas. 


JTable: Presenta datos en un formato de tabla bidimensional. 
JTextArea: Área de múltiples líneas que visualiza texto plano. 
JTextFieEd: Permite la edición de una línea de texto sencilla. 
JTextPane: Componente de texto que se puede marcar con atributos. 
JToggleButton: Botón de dos estados. 

JToggleButton, ToggleButtonModel: Modelo de botón toggle. 


JToolBar: Barra de herramientas, útil para visualizar controles usados 
normalmente. 


JToolBar.Separator: Separador específico de barra de herramientas. 
JToolTip: Visualiza una utilidad para un componente. 


JTree: Visualiza un conjunto de datos jerárquicos. 


e JTree.DynamicUtilTreeNode: Permite separar vectoreslhashtables/ 
arrays/cadenas y crear nodos apropiados para los hijos. 


+ JTree.EmptySelectionModel: Modelo de elección de árbol que no per- 
mite seleccionar nada. 


e JViewport: Vista mediante la que se ve información. 


e Window: Ventana que puede visualizarse en cualquier sitio del escrito- 
rio. 


Una cosa que deberíamos notar en esta lista es que todo control y contene- 
dor AWT, excepto JCanvas, tiene un sustituto en Swing; la razón es que la 
clase JPanel ya soporta todo lo que el componente Canvas soportaba, por lo 
que Sun no consideró necesario añadir un componente JCanvas por separado. 


Componentes peso pesado contra peso ligero 


¿Por qué no se añadieron a AWT todas estas mejoras y nuevos componen- 
tes? Esta pregunta hace que volvamos de nuevo a ver cuál es la diferencia 
básica en la filosofía de los componentes AWT y Swing. Cada componente 
AWT obtiene su propia ventana de la plataforma (y por lo tanto es como si 
fuera un control estándar de esa plataforma). En programas extensos, todas 
estas ventanas ralentizan el rendimiento y consumen gran cantidad de memo- 
ria. A tales componentes se les ha denominado pesos pesados. Los controles 
Swing, por otro lado, son sencillamente dibujados como imágenes en sus 
contenedores y no tienen una ventana de la plataforma propia, por lo que usan 
bastantes menos recursos del sistema. Por este motivo, se les denomina 
componentes peso ligero. 

Todos los componentes Swing se derivan de la clase JComponent, y esta 
clase es, a su vez, derivada de la clase AWT Container, que tiene ventana 
peso pesado (llamada compañero), por lo que JComponentes una clase peso 
ligero. Como se verá en este capítulo, JComponent añade una cantidad tre- 
menda de soporte de programación a la clase de componentes AWT. Observe 
que dado que los componentes Swing se derivan de JCornponent, y que 
JComponentse deriva de la clase Container de AWT, todos los componentes 
Swing son componentes AWT y se pueden mezclar controles AWT con 
controles Swing en los programas. 

Por lo tanto, dado que los controles Swing se dibujan en su contenedor, se 
pueden obtener resultados extraños porque los controles Java aparecerán por 
encima de ellos. 


Ahora todos los componentes Swing son pesos ligeros; para visualizar 
todo en un entorno de ventanas, son necesarias algunas ventanas del sistema 
operativo, no sólo para dibujar controles de peso ligero. Por esa razón, Swing 
soporta estas clases peso ligero: JFrarne, JDialog, JWindow y JApplet. 

Igual que construimos applets AWT usando la clase Applet y aplicaciones 
AWT usando la clase Frame, construiremos applets Swingen la clase JApplet 
y aplicaciones Swing usando la clase Jframe. El hecho de que Swing esté 
construido sobre AWT no significa nada para el programador, y los contene- 
dores peso pesado Swing de hecho tienen una estructura compleja para ser 
usados. De hecho, Swing con frecuencia tiene el sentimiento de que algo es 
añadido por una tercera parte, no por Sun. Por ejemplo, para pintar compo- 
nentes, no se sobrescribe el método paint nunca más, porque Swing necesita 
hacer eso para dibujar los bordes y todo lo demás, y tendremos acceso directo 
a las partes del programa en las que se dibujan los menús de cuadros de 
diálogo. Todo requiere un esfuerzo adicional de programación para pasar de 
AWT a Swing, como veremos en este capítulo. 


Características Swing 
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Además del granarray de componentes en Swing y el hecho de que sean peso 
ligero, Swing introduce muchas otras innovaciones. Estas son algunas de ellas: 


e Bordes: Se pueden dibujar bordes alrededor de los componentes, de 
diferentes, utilizando el método setBorder. 


° Debugging de gráficos: Se puede usar el método setDebugging- 
GraphicsOptions para iniciar el debugging de gráficos, lo que significa, 
entre otras cosas, que se puede ver cada línea cuando se está dibujando 
y hacerla un flash. 


e Facilidad de operaciones sin ratón: Ahora es fácil conectar las teclas a 
los componentes. 


e Tooltips: Se puede usar el método JCornponent.setToopTipText para 
dar a los componentes un tooltip, una de esas pequeñas ventanas con 
texto explicativo, que aparece cuando se mueve el ratón alrededor de un 
componente. 


e Facilidad de desplazamiento: Ahora se puede conectar el desplazamien- 
to a varios componentes, algo que era imposible con AWT. 


e Apariencia: Se puede establecer la apariencia de las applets y aplicacio- 
nes como cualquiera de los tres estándares: Windows, Motif (Unix) o 
Metal (la apariencia estándar de Swing). 


e Nuevos gestores de esquemas: Swing introduce los gestores BoxLayout 
y Overlayout. 


De todas esta innovaciones, la apariencia es probablemente la más impor- 
tante, porque permite seleccionar el estilo de la apariencia del programa. En 
AWT, los controles se construían en ventanas de la plataforma, lo que hizo 
que los programas AWT tuvieran una apariencia dependiente de la platafor- 
ma, y esto no era una buena idea para un lenguaje que estaba orgulloso de ser 
multiplataforma. Por ejemplo, ya que fuentes y controles diferentes se usan 
en diferentes plataformas, el esquema de los programas podría aparecer dife- 
rente en distintas plataformas. Swing introduce la apariencia Metal, que es la 
nueva apariencia de Java, y será igual en todas las plataformas. Adicionalmente, 
se puede dar a los programas una apariencia de Windows o Motif. Veremos 
este proceso en este capítulo. 


> Truco: Sun ha creado varias apariencias que no se entregan con IDK, 


ana para Apple Macintosh y otra independiente de la plata- 
-Torma llamada Organic, 


Entre AWT y Swing hay dos diferencias de programación esenciales. Una 
es que cuando se crean applets Swing y aplicaciones se trabaja con paneles, y 
la otra es la arquitectura de programación Modelo-Vista-Controlador. Prime- 
ro revisaremos cómo Swing funciona con paneles, ya que hay que entender 
cómo lo hacen los paneles antes de fijarlos en cualquier sitio en Swing. 


Truco: aquí indicamos otra diferencia entre AWT y Swing: Cuando se 
vuelven a dibujar elementos en la pantalla de AWT, primero se llama al 
método update para dibujar el fondo del elemento, y los programadores 
con frecuencia sabrescriben update para llamar al método paint direc- 
tamente, evitando así las fluctuaciones. Ea Swing, por otro lado, el 
método mødte no vuelve a ditmjar el Fondo de:l elemerlto, ya que los 
componentes pueden ter transparentes. en su lugar, update llama a 
paun directamente, 


Utilizar paneles en la programación de gráficos 


Las clases que son la base de las applets y aplicaciones, JApplet y JFrame, 
tienen un objeto hijo que hace todo el trabajo de gráficos, y este objeto es de 
la clase JRootPane. En la programación AWT, directamente, sólo se pueden 


añadir componentes a lasappletso ventanasfrarne. pero en Swing es un poco 
más complejo. Aunque realmente se pueden añadir componentes directamen- 
te aJFrame o JApplet, se obtendrá un error a menos que primero se desactive 
la verificación de errores, porque se espera que los añada al content Pune del 
objeto JRootPane. 

Esta es la estructura de un JRootPane: el panel tiene otros dos, un layered 
pane y un glass pane. El glas pane es realmente un objeto Component de 
AWT que pasa por todo el resto y que intercepta los eventos de ratón cuando 
se hace que este panel sea visible (aunque generalmente es transparente) y 
añade un Mouse listener. El layered pane, que es de la clase JLayeredPane, 
es donde tiene lugar la mayoría de las acciones. Hay capas específicas que 
tienen acceso, que visualizan menús y cuadros de diálogo cuando se abren. 
Desde el punto de vista del programador, probablemente los elementos más 
interesantes en el layered pane son la barra de menús y el área de trabajo. El 
content pane es realmente un objeto de la clase AWT Container (no hay clase 
JContentPane), y es donde las applets y las aplicaciones visualizan sus com- 
ponentes. En la práctica, esto significa que cuando se añaden componentes a 
un programa, se les añade al área de trabajo, que quiere decir que primero hay 
que obtener una referencia de dicho panel. Si se tiene una barra de menú en el 
programa, soportado con el objeto JMenuBar, se visualiza sobre el content 
pane. 


Truco: los content pane de Swing utilizan el pestor baritir Lava por 
defecto, mientras que las applets AWT utilizan flow layout por defecto 
y las ventanas frame A WT, el border layout. 


Arquitectura Modelo-Vista-Controlador 


Hay un último punto que tratar antes de pasar a la programación Swing: la 
arquitectura Modelo-Vista-Controlador (MVC). Esta arquitectura es el cora- 
zón de la programación de componentes Ul de Swing, y la comprensión del 
término es fundamental. Esto es lo que este término significa: el modelo de 
un componente está donde están almacenados sus datos, comoel estado de un 
botón o los elementos de una lista. La vista es la representación en pantalla 
del componente, como la forma en que aparece un botón o una lista. Final- 
mente, el controlador es la parte del componente que gestiona la entrada, 
como los clics del ratón. 

Dividir grandes programas en vistas y documentos, como en Microsoft 
Visual C++, se ha convertido en algo estándar. En este caso, una vista pro- 


porciona una ventana en un documento, que es donde los datos del programa 
se almacenan; múltiples vistas pueden proporcionar múltiples ventanas en el 
documento. Swing, inspirado en el lenguaje Smalltalk, va más adelante y 
basa sus componentes Ul en la arquitectura MVC. Como se puede imaginar, 
en Swing es útil separar la vista del modelo, donde la apariencia de los 
componentes pueden cambiar con unas pocas líneas de código. Pronto verá 
más sobre la arquitectura MVC. 

Ahora que hemos dado una pasada rápida por Swing, es hora de pasar a la 
siguiente sección. 


Trabajar con Swing 


El programador novato aparece y dice, "De acuerdo, estoy preparado para 
empezar a trabajar con Swing. ¿Por dónde empiezo?" "Bien", le contesta, 
"probablemente por la clase JComponent". 

La clase JComponent es la base de todos los componentes Swing. Es una 
clase peso ligero derivada de la clase AWT Container. Formalmente hablan- 
do, JComponentes realmente la clase javax. swing. JComponent, porque javax 
es el paquete que contiene Swing. Este es el diagrama de herencia para 
JComponent: 


La clase JComponent añade bastantes cosas a la clase AWT Container, 
como la posibilidad de dibujar bordes predefinidos alrededor de componentes 
UL añadir objetos PropertyChangeListener, que son notificados cuando se 
cambia el valor de la propiedad, y mucho más. 

Para referencias, se debería echar un vistazo a las tablas 11.1, 11.2 y 11.3, 
que contienen los campos, constructores y métodos, respectivamente, de esta 
gran clase. 


Tabla 11.1.Campos de la clase JComponent. 


Descripción 


protected AccessibleContext accessi- Soporte de acceso. 
bleContext 


protected EventL ístenerList listenerList Lista de los listeners de eventos 
actuales. 


Descripción 


static String TTOL- TIP- TEXT- KEY Comentario que se visualizacuan- 
do el cursor está sobre el compo- 
nente. 


protected ComponentUl ui Interfaz de usuario. 


static int UNDEFINED-CONDITION Constante usada para indicar que 
no se ha definido ninguna con- 
dición. 


static int WHEN-ANCESTOR-OF - Usado por registerKeyboardAc- 
FOCUSED-COMPONENT tion(), indicando que se debería 


llamar al comando cuandoelcom- 
ponente que recibe es un proge- 
nitor del componente quetiene el 
foco. 


static int WHEN- FOCUSED Constante usada por registerKey- 
boardAction(), indicando que se 
debería llamar al comando cuando 
el componente tenga el foco. 


static int WHEN-IN-FOCUSED- Constante usada por registerKey- 

WINDOW boardAction(), indicando que se 
debería llamaralcomando cuando 
el componente tenga el foco. 


Tabla 11.2. Constructor de la clase JComponent. 


Constructor Descripción 
JEomponenti) Constructor por defecto de 
JComponent. 


Tabla 11.3. Métodos de la clase JComponent. 


Método Descripción 


voidaddAncestorListener(AncestorLis- Registra el listener para que 


tener listener) reciba AncestorEvents. 

void addNotify() Notificación de que este compo- 
nente tieneahora un componen- 
te padre. 

void addPropertyChangeListener Añade un PropertyChangeLis- 


(PropertyChangeListener listener) tener a la lista de listener. 


Método 


voidaddPorpertyChangeListener(String 
propertyName, PropertyChangeListener 
listener) 


voidaddVetoableChangeListener 
(VetoableChangeListener listener) 


voidcompute VisibleRect(Rectang1e 
visible Rect) 


boolean contains(intX, int y) 


JtoolTip create Tool Tip() 


void firePropertyChange(String property- 
Name, boolean oldValue, boolean new- 
Value) 


void firePropertyChange(String proper- 
tyName, byte oldValue, byte newvalue) 


void firePropertyChange(String property- 
Name, char oldValue, char newvalue) 


void firePropertyChange(String property- 


Name, double oldValue, double newvalue) de fronteras. 


void firePropertyChange(String property- 
Name, float oldValue, float newvalue) 


void firePropertyChange(String property- 
Name, int oldvalue, int newvalue) 


void firePropertyChange(String property- 
Name, long oldValue, long newvalue) 


void firePropertyChange(String property- 
Name, Object oldValue, Object new- 
Value) 


void firePropertyChange(Stringproperty- 
Name, short oldValue, short newvalue) 


protected void fire VetoableChange(String 
propertyName, Object oldValue, Object 
| newvalue) 


Descripción 


Añade un PropertyChange- 
Listenerpara una propiedad 
específica. 


Añade un VetoableChangeLis- 
tener a la lista de listener. 


Obtiene el rectángulo visible del 
componente. 


Determina si el componente 
contiene el punto dado. 


Obtiene la instancia de Jtoo! Tip 
que debería usarse para visua- | 
lizar el tooltip. 


Reportaun cambio de propiedad 
de fronteras. 


Reporta un cambio de propiedad 
de fronteras. 


Reportaun cambio de propiedad 
de fronteras. 


Reporta un cambio de propiedad 


Reporta un cambio de propiedad 
de fronteras. 


| 
| 


Reportaun cambio de propiedad 
de fronteras. 


Reporta un cambio de propiedad 
de fronteras. 


Proporciona soporte para repor- 
tar los cambios en las propieda- 
des de fronteras. 


Reportaun cambio de propiedad 
de fronteras. 


Proporciona soporte para repor- || 
tar los cambios de propiedades. | 
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Método 


AccessibleContextgeiAccessibleContext() 


ActionListenergetActionForKeyStroke 
(KeyStroke aKeyStroke) 


float getAlignmentX() 
float getAlignmentY () 
boolean getAutoscrolls() 


Border getBorder() 

Rectangle getBounds(Rectange rv) 
Object getClientProperty(Object key) 
protected Graphics getcomponent- 
Graphics(Graphics g) 
intgetConditionForKeyStroke(Key- 
Stroke aKeyStroke) 
intgetDebugGraphicsOptions() 
Graphics getGraphics() 


int getHeightO 


Insets getInsets() 


Insets getInsets(Insets insets) 


Descripción 


Obtiene el AccessibleContext | 
asociado con este JComponent. | 


Obtiene el objeto que ejecutará | 
la acción registrada para una | 
combinación de teclas dada. 


Obtiene la alineación vertical. 
Obtiene la alineación horizontal. 


Devuelve verdadero si este 
componente automáticamente 
desplaza su contenido cuando 
se arrastra. 


Obtiene el borde de este compo- 
nente o nulo si no está el borde. 


Almacena las fronteras de este | 
componente en rv y devuelve rv. | 


Obtiene el valor de la propiedad | 
con la tecla especificada. 


Obtiene el objeto gráfico usado 
para pintar este componente. 


Obtiene la condición que deter- 
mina si ocurre una acción para 
lateclaaceleradoraespecificada. 


Obtiene el estado del debugging 
de gráficos. 


Obtiene el contexto de gráficos 
de este componente. 


Obtiene la altura actual de este 
componente. 


Si se ha establecido un borde 

para este componente, el mé- 

todo obtiene los intercalados. 

De lo contrario llama a super. | 
get-insets. 


Obtiene un objeto Insets para | 
este componente. 


Mátodo Descripción 


Point getLocation(Point rv) Almacena el origen x,y de este 
componente en rv y devuelve rv. 


Dimension getMaximumSize() Obtiene el tamaño máximo del 
componente. 

Dimension getMinimumSize() Obtiene el tamaño mínimo del 
componente. 

ComponentgetNextFocusableCom- Obtieneelsiguientecomponente | 

ponent() que debe tener el foco o null. 

Dimension getPreferredSize() Si el tamaño preferido se ha es- 


tablecido a un valor no nulo, 
este método lo devuelve. 


KeyStroke[] getRegisteredKeyStrokes() Obtiene las teclas aceleradoras 
que inician acciones. 


JRootPane getRootPane() Obtiene el progenitor de un com- 
ponente. 

Dimension getSize(Dimension rv) Almacenala anchura y altura de 
este componente en rv y devuel- 
ve rv. 

Point getToolTipLocation(Mouse Event Obtiene la posición del tooltip 

event) en el componente. 

String elfo Tip Text Obtiene la cadena tooltip que 
se ha establecido consetToo!Típ- 

Texto. 


String getToolTipText(MouseEventevent) Obtiene la cadena a utilizar por 
el tooltip en ese evento. 


ContainergetTopLevelAncestro() Obtiene el primer antecesor del 
componente. 
String getUlClassID() Obtiene la clave UlDefaults 


usada para encontrar el nombre 
de la clase swing.plaf. Compo- 


nentUl. 

Rectangle getVisibleRect() Obtiene el rectángulo visible del 
componente. 

int getWidth() Obtiene la anchura actual. 

int getX() Obtiene la coordenada x actual 


del origen de este componente. ' 
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Método Descripción 


int getY() Obtiene la coordenada y actual 
del origen de este componente. | 

void grabFocus() Fija el foco en el componente. 

boolean hasFocus() Devuelve verdadero si este 
componente tiene el foco delte- 
clado. 

boolean i¡sDoubleBuffered() Indicasi el componente receptor 


debería usar un bufferpara pin- | 
tar. | 


boolean isFocusCycleRoot() Devuelve verdadero si elcompo- 
nente es la raíz de un árbol de 
componente con un ciclo de foco. 


boolean isFocusTraversable() Especifica si este componente 
puede recibir el foco. 


static boolean isLightweightComponent Devuelve verdadero si este 
(Component c) componente es peso ligero. 


boolean isManagingFocus() Devuelveverdadero si elcompo- 
nente gestiona el foco. 


boolean ¡sopaque() Devuelveverdadero si elcompo- 
nente es opaco. 


boolean isOptimizedDrawingEnabled0 Devuelveverdaderosielcompo- 
nente titula a sus hijos. 


boolean isPaintingTile() Devuelveverdaderosi elcompo- 
nente está pintando un entra- 
mado. 


boolean isRequestFocusEnabled() Devuelveverdadero si elcompo- 
nente receptor puede obtener el 
foco. 


Preparar para crear un applet Swing 
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"De acuerdo", dice el programador novato, "estoy preparado para empezar 
a crear applets usando Swing. ¿Cómo lo hago?" "Con la clase JApplet", le 
responde, "coja una silla y veámoslo". 

La clase JApplet es un contenedor peso pesado que es la base de las 
applets Swing y una extensión de la clase Applet AWT. Esta clase tiene un 


hijo, un objeto de la clase JRootPane, y es donde se continúa el dibujo y 
donde se añaden los componentes. Este es el diagrama de herencia de J Applet: 


aya. lang. 0bjëēot 


Los campos de esta clase se encuentran en la tabla 11.4, su constructor en 
la 11.5 y sus métodos en la 11.6. 

Para arrancar un applet Swing, basta derivar una clase de la clase JApplet 
como sigue (observe que importamosjavax.swing. ú para usar JApplet): 


import java.awt.*; 
import javax.swing.*; 


public class applet extends JApplet 
I 


Desafortunadamente, en este punto, se complican más las cosas (cuando 
se quiere dibujar en un applet o añadir controles en él), porque normalmente 
se trabaja con el content pane en la applet en lugar de hacerlo en la applet en 
sí misma. 


Tabla 11.4. Campos de la clase JApplet. 


Descripción 


protected AccessibleContext accessi- Accesibilidad a un contexto. 
blecontext 


protected JRootPane rootPane Panel raíz. 

protected boolean rootPanechecking- — Indicasiseproduciránerroresal in- 

Enabled tentar añadir componentes al root 
pane. 


ii 


Tabla 11.5. Constructor de la clase JApplet. 


JADEN) 


protected void addlmpl(Component 
comp, Object constraints, intindice) 


protectedJRootPane createRootPane() 


AccessibleContext getAccessible- 
Contexto 
ContainergetContentPane() 
CornponentgetGlassPane() 
AMHenuBar gehMenu Bari) 
JLayeredPanegetLayeredPane() 
JRootPane getRootPane() 
protectedboolean isRootPaneCheck- 
ingEnabled() 


protected String pararnStringO 


protected void processKeyEvent 
(KeyEvent e) 


void remove(Component cornp) 


void seíContentPane(Containercon- 
tentPane) 


| voidsetGlassPane(Componentglass- 


Pane) 
void setJMenuBar(JMenu5ar rnenuBar) 


Constructor Descripción 


Crea una instancia a un applet 
Swing. 


Añade hijo al content pane. 


Lo llaman los métodos del cons- 
tructor para crear el rootpanepor 
defecto. 


Obtiene el contexto accesibleaso- 
ciado con esta JApplet. 

Obtiene el objetocontentPanepa- 
ra esta applet. 


Obtiene el objeto glasspanepara 
esta applet. 


Obtiene la barra de menú para 
esta applet. 


Obtiene el objeto layeredPane 


para esta applet. 


Obtiene el objeto rootPane para 
esta applet. 


Devuelve verdadero si la verifica- 
ción delrootpaneestá habilitado. 


Obtiene una representación en 
cadena de esta JApplet. 


Procesa eventos clave que ocu- 
rren en este componente envián- 
dolos a los objetos KeyListener. 


Eliminaelcomponenteespecifica- 
do de este contenedor. 


Fija la propiedad contentpane. 


Obtiene la propiedad glasspane. 


Obtiene la barra de menú de esta 
applet. 


Constructor Descripción 


void setLeyeredPane(JLayeredPane Obtienela propiedad layeredPane. 


layeredPane) 

void setLayout(LayoutManager ma- Fija el esquema de este content 

nager) pane. 

protected void setRootPane(JRootPane Fija la propiedad rootpane. 

root) 

protected void setRootPaneChecking-  Siesverdadero,llamaa addy set- 

Enabled(boo1ean enabled) layoutcausará una excepción. | 

void update(Graphics g) Llama paint(g).No vuelve a dibu- 
jar el fondo. 
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Tanto JApplet como JFrame tienen un objeto hijo, un objeto de la clase 
JRootPane, y el content pane es parte de root pane. Echaremos un vistazo a 
los root panes en el siguiente punto. 


Comprender los root panes 


La clase JRootPane es la clase que gestiona la apariencia de los objetos de 
JApplet y JFrame. En particular, el root pane contiene glass pane, content 
pane y layered pane, que veremos en la programación Swing. 

Este es el diagrama de herencia para JRootPane: 


java. lang.Object 
Ijava.awt.Component 
lIjava.awt.Container 
Ijavax.swing.JComponent 
Ijavax.swing.JRootPane 


Los campos de la clase JRootPane los encontrará en la tabla 11.7, su 
constructor en la 11.8 y sus métodos en la 11.9. 


Tabla 11.7. Campos de la clase JRootPane. 


Campo Descripción 
protected Container contentpane El content pane. 


protected JButton defauliButton Botón que está activado cuando el 
panel tiene el foco y se produce una 
acción, como es presionar la tecla 
Intro. 


Campo 


protectedjavax.swing.JRootPane. 
DefaultAction defaultPressAction 


protectedjavax.swing. JRootPane. 
DefaultAction defaultReleaseAction 


protected Component glassPane 


Descripción 


Acción que se produce cuando se 
presiona el botón por defecto. 


Acción que se produce cuando el bo- 
tón, por defecto, se suelta. 


Glass pane que cubre la barra de 
menú y el content pane, por lo que 
pueden interceptar los movimientos 
de ratón. 


protected JLayeredPane layeredPane El layered pane que gestiona la 


protected JMenuBar menuBar 


barra de menú y el content pane. 


Barra de menú. 


Tabla 11.8. Constructor de la clase JRootPane. 


Constructor 


JRootPanel() 


Descripción 


Crea un componente JRootPane, 
estableciendo sus componentes 
glasspane, LayeredPane y content- 
Pane. 


Tabla 11.9. Métodos de 


Método 


protected void addlmpl(Component 
comp, Object constraints, intindice) 


void addNotify() 


protected Container createcontent- 
Pane() 


protected Component createGlass- 
Pane() 


protected JLayeredPane createpane. 
LayeredPaneO 


| protected LayoutManagercreateRoot- 


Layout0 


la clase JRootPane. 


Descripción 


Sobrescrito por Swing. 


Registra un nuevo root pane. 


Llamado por los métodos cons- 
tructores para crear elcontentpane | 
por defecto. 


Llamado por los métodos construc- 
tores para crear el glass pane por 
defecto. 


Llamado por los métodos construc- 
tores para crear el layered por de- 
fecto. 


Llamado por los métodos construc- 
tores para crear el layout manager 
por defecto. 


| Metodo 
Component findComponentAt(int x, 
int y) 


AccessibleContextgetAccessible- 
Contexto 


ContainergetContentPane() 
JButton getDefaultButton() 
Component getGlassPane() 
JMenuBar getJMenuBar() 


JLayeredPane getL ayeredPane() 
JMenuBar geiMenuBar() 
boolean ¡SFocusCycleRoot() 
boolean is Validate Root() 
protected String paramString() 
void removeNotity() 


void setDefauliButton(Jbutton de- 
fauliButton) 


| layered) 
void setMenuBar(JMenuBar menu) 


voidsetContentPane(Containercontent) Fija el content pane. 


voidsetGlassPane(Componentglass) 


void setJMenuBar(JMenuBar menu) 


voidsetLayeredPane(JLayeredPane 


Descripción 


Localiza el componente hijo visible 
que contiene la posición especi- 
ficada. 


Obtiene el contexto accesible. 


Obtiene el content pane. 
Obtiene el botón por defecto. 
Obtiene el glass pane. 


Obtiene la barra de menú del layered 
pane. 


Obtiene el layered pane usado por 
el root pane. 


Obsoleto. Reemplazado por getJ- 
Menubar(). 


Forma la raíz de un ciclo de foco. 


Si un descendiente de esta JRoot- 
Panellamaa revalidate,la validación 
tendrá lugar de aquí hacia abajo. 


Obtiene una representación en 
cadena de root pane. 


Elimina el registro desde System- 
EventQueueUtils. 


Fija el botón actual por defecto. 


Fija un componente especificado 
para ser el glass pane para este 
root pane. 


Añade o cambia la barra de menú 
Usada en el layered pane. 


Fija ellayeredpanepara elrootpane. 


Obsoleto. Reemplazado porsetJMe- 
nuBar. 
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Para construir applets y aplicaciones, generalmente se trabaja con el content 
pane del root pane. El content pane en sí mismo, sin embargo, es parte de 
otro panel, el layered pane. Lo veremos en el siguiente punto. 


Comprender layered panes 
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Los layered pane del root pane gestionan los componentes actuales que 
aparecen en lasapplets y aplicaciones, incluyendo barras de menú y el content 
pane. Este es el diagrama de herencia para la clase de layered pane, 
JLayeredPane: 


aaisa dina THaveredt 


Por conveniencia, JLayeredPane divide el rango en varias capas diferen- 
tes. Poner un componente en una de estas capas hace que sea más fácil 
asegurarse de que los componentes se solapen adecuadamente, sin tener que 
preocuparse de especificar los miembros para cada espesor: 


e DEFAULT-LAYER: La capa estándar y la de más al fondo, donde van 
los componentes. 


e PALETTE-LAYER: La capa de paleta se pone como defecto y es útil 
para barras de herramientas y paletas flotantes. 


e MODAL-LAYER: Capa usada para cuadros de diálogo modales. 


e POPUP-LAYER: Capa de menú emergente que se visualiza sobre la 
capa de diálogo. 


e DRAG-LAYER: Cuando se arrastra un componente, asignándolo a la 
capa de arrastre, se asegura de estar situado sobre otro componente en el 
contenedor. 


Para la reposición de un componente dentro de su capa, se puede usar los 
métodos JLayeredPane, moveToFront, moveToBack y setposition. También 
se puede utilizar el método setLayer usado para cambiar la capa actual del 
componente. Los campos de la clase JLayeredPane se encuentran en la tabla 
11.10, su constructor en la 11.11 y sus métodos en la 11.12. 

Como es típico que las operaciones de dibujo vayan en applets y aplica- 
ciones, la parte más importante del layered pane es el content pane. LO 
veremos en el siguiente punto. 


Tabla 11.10. Campos de la clase JLayeredPane. 


Descripción 


| static Integer DEFAULT-LA YER Capa por defecto. 
static Integer DRAG- LAYER Capa de arrastre. 
| statis Integer FRAMECONTENT-LAYER Capa frame content. 
| static String LA YER- PROPERTY Propiedad de frontera. 
| static Integer MODAL-LAYER Capa modal. 
static Integer PALETTE-LA YER Capa de paleta. 
static Integer POPUP-LAYER Capa de menú emergente. 


Tabla 11.11. Constructor de la clase JLayeredPane. 


Constructor Descripción 
JLayereodPane() Crea un nuevo objeto JLaye- 
redPane. 


Tabla 11-12. Métodos de la clase JLayeredPane. 


Método Descripción 


protected void addlmpl(Component index- Añade el componente indicado 
comp, Object constraints, intindice) a este contenedor. 


AccessibleContextgeiAccessibleContext() Obtiene el contexto accesible. 


int geiComponentCountinLayer(intlayer) Obtiene el número de hijos en 
la capa indicada. 


Component[] getComponentinLayer (int Obtiene un arraydelos compo- 


/ayer) nentes en la capa indicada. 
protected Hashtable getcomponent- Obtiene el hashtableque hace 
ToLayero corresponderlos componentes 


con las capas. 


int getindexOf(Component c) Obtiene el atributo capa para 
el componente indicado. 


static int getLayer(JComponent c) Obtiene la propiedad de capa 
para un JComponent y no 
causa ningún efecto lateral | 
como setLayer(). 
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(Metodo Descripción 


static JLayeredPane getl ayeredPane- Obtiene el primer JLayered- 
Above(Componentc) Pane, que contiene el compo- 
nente indicado. 


protected Integer getObjectForL ayer(int Obtiene el objeto Integer con 
layer) una capa indicada. 


intgetPosition(Component c) Obtiene la posición relativa del 
componente dentrode su capa. 


int highestlayero Obtiene el valor de la capa más 
alta desde el hijo actual. 


protected int insertIindexForLayer(int layer, Determina la propia ubicación 

intposición) en la que se inserta un nuevo 
hijo basado en la capa y la po- 
sición. 

boolean isOptimizedDrawingEnablea() Devuelve falso si los compo- 
nentes en el panel pueden 
solaparse. 


int lowestlL ayer() Obtiene el valor de la capa más 
baja desde el hijo actual. 


void moveToBack(Componenic) Mueve el componentea la parte 
superior de los componentes 
en su capa actual. 


void paint(Graphics g) Pinta el layered pane usando 
un contexto gráfico. 
protected String paramStringO Obtiene una representaciónen 
cadena de este Jl ayeredPane. 
static void putL ayer(JComponent c, int Fija la propiedad de capa en un 
layer) JComponent. 


void remove(intíndice) Retiraelcomponenteindexado 
de este panel. 


void setLayer(Component c, int layer, int Fija el atributo de la capa para 

posición) el componente indicado y 
además fija su posición dentro 
de esta capa. 


void setPosition(Componentc, intposición) Mueve el componente a la 
posición dentro de su capa 
actual. 


Comprender los content panes 


Generalmente, los controles y los gráficos se sitúan en un contentpane de 
un applet o aplicación. Se puede esperar que el content pane lo soporte su 
propia clase, pero de hecho, un contentpanees sólo un objeto Container (que 
es una clase peso ligero). Se puede tener acceso al contentpane en el layered 
pane de un applet o aplicación, usando el método getContentPane de las 
clases JApplet y JFrame. 

La importancia del content pane se debe a que es el lugar donde general- 
mente se añaden componentes a las applets y aplicaciones, así como donde se 
dibujan gráficos; esto marca una gran diferencia con la programación AWT. 
Otro punto importante es conocer qué content panes usa, por defecto, border 
layout. Para ver cómo funciona esto realmente en el código, echemos un 
vistazo al siguiente punto. 


Crear un applet Swing 


"De acuerdo", dice el programador novato, "estoy preparado para crear un 
applet Swing y añadir elementos al content pane. ¿Cómo se hace esto?" 
"Siéntese y discutámoslo", le contesta. 


Pintar en Swing frente a AWT 


Cuando hemos visto el contenido de AWT antes en este capítulo, quizás 
estuviera esperando ver un método paint para gestionar las operaciones de 
pintura y los gráficos en applets y aplicaciones Swing. De hecho, hay un 
método paint, pero no debería sobrescribirlo a menos que realmente sepa lo 
que está haciendo, porque Swing, en sí mismo, utiliza ese método para dibu- 
jar los bordes alrededor del componente, así como para dibujar cualquier 
componente hijo en el componente, entre otras tareas. 

En lugar de usar el métodopaint para las operaciones de pintura, ahora se 
utiliza el métodopaintComponent. Éste tiene algunas ramificaciones al crear 
applets y aplicaciones, comparado con la programación AWT. En lugar de 
sobrescribir, s610, el método paint de la applet o ventana frame, ahora hay 
que crear un componente para pintar en él. Esto se debe hacer porque el 
content pane en un programa no es una clase en la que se puedan sobrescribir 
métodos, sino que es un objeto (una alternativa es crear una clase content 
pane personalizada y usar el método setContenrPane para instalarla en el 
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programa). Además, observe que cuando se trabaja con paintlomponent, lo 
primero que se debería hacer es llamar a super.paintComponent, el método 
paintcomponent de la super clase. 


Visualizar controles en Swing frente a AWT 


Para añadir controles a un content pane, se usa el método add del content- 
pane. Tanto en applets como en aplicaciones se usa por defecto el border 
layout, a diferencia de la programación AWT, en la que las applets usanflow 
layout y las ventanas frame, border layout. 

Para añadir controles a un content pane, primero hay que fijar el layout 
manager como se quiera, o usar el border layout por defecto. Para añadir 
controles, usaremos el método add, como se hace en la programación AWT. 

Veamos un ejemplo. En este caso, visualizamos el texto "¡Hola desde 
Swing!" en un applet. ¿Cómo se visualiza el texto? No podemos visualizarlo 
en el contentpane por defecto de la applet, ya que es un objeto, no una clase, 
por lo que no podemos sobrescribir su método paintcomponent. Por otro 
lado, no se puede añadir un panel, representado por la clase JPanel, a la 
applet para que cubra el content pane. 

Además se puede dibujar en ese panel sobrescribiendo su métodi 
paintlomponent. Observe que se podría crear una nueva clase contentpane, 
sobrescribir su método paintlomponent, e instalarlo con el método 
setContentPane, pero JPanel generalmente se utiliza para crear content pa- 
nes de cualquier forma. 


Truco: si quiere saber exactamente qué valores se usaron para cons- 
truir un compontiile wisilal tal como JAppier, se le dí el foco, se' 
presionan las te das Mayiús-lontel-Fl y se va a la consola para tener 
una visión compl-"ia 


Usar la clase JPanel 


La clase JPanel es la clase contenedora para cualquier propósito deSwing, 
y es importante conocerla. Este es el diagrama de herencia de JPanel: 


Al contrario que los contenedores peso pesado de Swing, JPanel usa por 
defecto unflow layout. Los constructores de la claseJPanelse encuentran en 
la tabla 11.13 y sus métodos en la tabla 11.14. 


Tabla 11.13. Constructores de la clase JPanel. 


Constructor Descripción 


JPanati) Construye un nuevo JPanelcon 
un doble buffer y un flow layout. 


JPanel(boo1ean isDoubleBuffered) Construye un nuevo JPanelcon 
un flow layout y la estrategia de 
bufferespecificada. 


JPanel(LayoutManagertayout) Construye un nuevo JPanelcon 
el layout managerespecificado. 


JPanel(LayoutManagerlayout, boolean Construye un nuevo JPanelcon 
isDoubleBuffered) ellayoutmanagery la estrategia 
de buffer especificados. 


Tabla 11.14. Métodos de la clase JPanel. 


Métodos Descripción 
AccessibleContext getAccessible- Obtiene el contexto accesible. 
Contexto 

String getUlClassID() Obtiene una cadena que espe- 


cifica el nombre de la clase que 
devuelve este componente. 


protected StringparamString() Obtiene una representación en | 
cadena de JPanel. 

void updateUl() Se le llama cuando la apariencia 
ha cambiado. 


A continuación crearemos una clase JPanel que visualiza el texto "¡Hola 
desde Swing!" (observe que a este panel se le está dando un fondo blanco y 
que se sobrescribe el método paintcomponent; se le pasa un objeto AWT 
Graphics, que se puede usar para escribir el texto): 


class jpanel extends JPanel 


{ 
jpanel (1 
I 


setBackground (Color .white) ; 


ih 
È 
=g 


public void paintcomponent (Graphics g) 
c 


super .paintComponent (g) ; 
g.drawString("iAola desde Swingl", 0, 60); 


1 
Ahora se puede añadir un objeto de esta nueva clase al contentpane de un 


applet usando el método getContentPane de la clase JApplet, y después usar 
el método add del content pane para añadir el panel: 


import java.awt.*; 
import javax.swing.*; 


public class applet extends JApplet 


{ 
jpanel j; 


public void inito0 
{ 
Container contentpane = getContentPane0; 


j = new jpanel(); 
contentPane.add (3); 


class Jpanel extends JPanel 


I 
jpanel (1 


setBackground (Color.white) ; 


public void paintcomponent (Graphics g) 
c 


super .paintComponent (g) ; 
g.dra-String(“-iHoladesde Swinglw, 0, 60); 
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Ahora se puede compilar y ejecutar esta applet, como se muestra en la 


figura 11.1. Este ejemplo está en el CD que acompaña a este libro como 
appler java. 


En 


apple: eee apple cla 


f 


¡Hola desde Drs 


Apie started 


Figura 11.1. Un applet Swing. 


Crear una aplicación Swing 


"De acuerdo", dice el programador novato, "estoy preparado para crear 

una aplicación usando Swing. ¿Por dónde empiezo?" "Creando una ventana 

frame "Je dice. "¿Usando la clase Frame?,” pregunta NP. "No", le contesta, 
"la clase JFrame". 

Al igual que en las aplicaciones AWT generalmente usamos una ventana 
frame, cuando se crean aplicaciones en Swing se usa un objeto JFrame, que 
tiene un root pane hijo. 

Este es el diagrama de herencia para JFrame (observe que se deriva de la 
clase Frame y es un contenedor peso pesado): 


java.lang.Object 
ljava.awt.Component 
Ijava.awt.Container 
j ava.awt. Frame 
Ijavax.swing.JFrame 


Los campos de la clase JFrame se encuentran en la tabla 11.15, sus 
constructores en la 11.16 y sus métodos en la tabla 11.17. Observe que el 
layout por defecto en un JFrame es un border layout. 


Tabla 11.15. Campos de la clase JFrame. 


A] 


protected AccessibleContext accessibleContext Contexto accesible. 


protected JRootPane rootfane Root paneque gestiona el 
contentpane, barra de me- 
nú y glass pane. 


protected boolean rootPaneCheckingEnabled Si es verdadero, llama a 
add y setlayout produce 
una excepción. 


Tabla 11.16. Constructores de la clase JFrame. 


Constructor Descripción 
JFrame() Crea un nuevo frame 


JFrame(Títu1t0) Crea unnuevoframe coBal 
título especificado 


Tabla 11.17. Métodos de la clase JFrame 


Método Descripción 


protected void addlmpl(Component como, Añade hijos al contentpane. 
Object constraints, intindice) 


protected JRootPane createRootPane() Llamado por los métodos 
del constructor para crear 
el root pane por defecto. 


protected void framelnit() Llamado por los construc- 
tores para inicializar la 
propiedad JFrame. 


AccessibleContext getAccessibleContext() Obtiene el contexto accesi- 
ble asociado con este 
JFrame. 


ContainergetContentPane() Obtiene el objeto content 
pane de este frame. 


int getDefaultCloseOperation() Obtiene la operación que 
tiene lugar cuando el išua= 
rio cierra el frame. 


Component getGlassPane() Obtiene el objeto glass- 
Pane. 


Método Descripción 


JMenuBar getJMenuBar() 
JRootPane getRootPane() 


Obtiene la barra de menú. 
Obtiene el root pane. 


protectedbooleanisrootiPaneCheckingEnabled() Indica si llama a addy set- 
Layout causa una excep- 
ción. 

protected String paramString() Obtiene una representa- 

ción en cadena de este 

JFrame. 


protected void porcessKeyEvent(KeyEvent e) Procesa los eventos de te- 
cla que ocurren en este 


componente. 
protected voidprocess WindowEvent(Window- Procesa eventos de venta- 
Event e) na que ocurren en este 
componente. 


void remove(Component comp) Elimina el componente de 


este contenedor. 


voidsetContentPane(Containercontentpane) Obtiene la propiedad con- 
tentPane. 


void setDefaultCloseOperation(intoperación) Fijala operación que tendrá 
lugar, por defecto, cuando 
elusuariocierre este frame. 


void setGlassPane(Componenteglasspane) Fija la propiedad glass- 
Pane. 


void setiMenuBar(JMenuBar menubar) Establece la barrade menú 
para este frame. 


void seilLayeredPane(JLayeredPane layered- Fija la propiedad layered- 


Pane) Pane. 

void setL ayout(LayoutManager manager) Por defecto, se debería fijar 
el layout del content pane 
en su lugar. 


protected void setRootPane(JRootPane root) Fijalapropiedad rootPane. 
protected void setRootPaneCheckingEnabled Determina si llama a addy 


(boolean enabled) setLayout causa una ex- 
cepción. 
void update(Graphics g) Llama a paint. 


Ahora, pondremos a funcionar la clase JFrame. En este caso, crearemos E 
un objeto JPanel (como en el punto anterior), instalaremos el panel en un 
objeto JFrame, y visualizaremos el texto "¡Hola desde Swing!" en el panel. 
El color de fondo por defecto de JFrame es gris, pero haremos que el panel 
sea blanco fijando su color de fondo. Este es el código: 


class jpanel extends JPanel 


{ 


Bst BackgroandiColor:-:whitej j 


public void paintcomponent (Graphics g) 
i 


super .paintC-onent (g) ; 
g.dra-String(--HoMHesdel", 0, 60); 
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E ES ; RO y 
A continuación, creamos un objeto de esta nueva clase y lo añadimos al 
content pane de JFrame en una aplicación, como sigue: 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 


public class app extends JFrame 


I 
jpanel 3; 


public app() 
I 


super ("Aplicación Swing"); 


Container contentpane e get-ontentPane0; 
j = new jpanel (); 
contentPane.add (3); 


public static void main(String argsil) 
I 


final JFrame f = new app(): 


100, 300, 3005 


class jpanel extends JPanel 
I 

jpanel () 

I 


public void paintcomponent (Graphics g) 


super .paintComponent (g); 
g.drawString("iHola desde Swing!", 0, 60); 
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Ahora, además, hemos usado el método setBounds para fijar la posición y 
tamaño de la ventana JFrame. El resultado se muestra en la figura 11.2. Este 
ejemplo se encuentra en el CD como app.java. 

Sin embargo, hay un problema con esta aplicación. Cuando se cierra esta 
ventana de aplicación haciendo clic en el botón Cerrar, desaparece de la 
pantalla (que es más de lo que una ventana de aplicación AWT haría), pero la 
aplicación no finaliza. Para remediar esta situación, veamos el siguiente 
punto. 


E Aplicación Teej 


Hola rude Faing 


Figura 11.2. Visualizar una aplicación Swing en una ventana frame. 


Cerrar ventanas JFrame 


"Hey", dice el programador novato, "otra vez Java está graciosillo. Cuan- 
do intento cerrar una ventana JFrame de Swing, no hace nada". "Bien", le 
contesta, "se puede solucionar de varias formas". "Tomemos un café", dice PN. 

Cuando se cierra una ventana AWT, por defecto, no pasa nada, pero se 
pueden gestionar los eventos de ventana y finalizar la aplicación si se quiere. 
Las ventanas JFrame de Swing, por otro lado, permiten establecer una opera- 
ción de cierre por defecto con el método setDefaultCloseOperation.Estos 
son los valores posibles que se le pueden pasar a este método: 
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+ DO-NOTHING-ON-CLOSE: El defecto. No pasa nada cuando se cie- 
rra la ventana. 


e HIDE-ON-CLOSE: Esconde la ventana cuando se cierra. 


e DISPOSE-ON-CLOSE: Se libera de la ventana cuando se cierra. No se 


puede volver a visualizar la ventana, aunque el objeto todavía está 
disponible en memoria. 


Observe que estas posibilidades sólo tratan con la ventana en sí misma; si 
se quiere finalizar la aplicación cuando la ventana de aplicación se cierra, 
todavía tendrá que gestionarse. 

A continuación, nos liberamos de la ventana y finalizamos la aplicación 
con una clase interna adaptadora: 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 


public class app extends JFrame 


( 
jpanel j; 


public app () 
{ 


super ("Aplicación Swing"); 


Container contentpane = getContentPane0; 
j = new jpanelo; 
contentpane.add (3); 


public static void main (String argsil) 


{ 


final JFrame f = new app0; 


E. sertbocunde(100, 100, 300, 300); 
aatisible(crual: 


£.retbefaultClossóperation  DISPOSE_0N_CLOSE]: 


£.addWindowLiitener (new WindorAdapterO < 
public void windor-locied(“-ind-e)Jt ( 
Syntam.exit (0) 3 
1 
1); 


class jpanel extends JPanel 


( 


public void paintcomponent (Graphics g) 
{ 
super .paintComponent (g); 
g.drawStringíU ¡Hola desde Swing!', 0, 60); 


Seleccionar los bordes del componente 


"Bien", dice el programador novato, "el gran jefe quiere que nuestros 
programas sean más decorativos, visualmente más atractivos. ¿Alguna idea?" 
"Bien", le contesta, "puede usar diferentes tipos de bordes para los componentes 
en Swing. Es bastante fácil". "¿Cómo funciona?" pregunta PN, interesado. 

Para crear un borde de un componente, se puede usar la clase 
BorderFactory, que crea bordes de estas clases: BevelBorder, SoftBevelBorder, 
EtchedBorder, LineBorder, TitledBorder y Matte Border. Además se pueden 
usar las clases EmptyBorder, CompoundBorder y AbstractBorder para crear 
los propios bordes. 

Este es el diagrama de herencia de la clase BorderFactory: 


ña Wing 


Los métodos de la clase BorderFactory se recogen en la tabla 11.18. 
La clase BorderFactory crea objetos que implementa la interfaz Border; 
los métodos de la interfaz están en la tabla 11.19. 


Usar Insets 


Una parte importante de trabajar con bordes es conocer los insets, que 
indican la distancia que se debe permitir en cada borde para considerarlo en el 
cálculo. 

Los insets de un borde se pueden obtener con el método getBorderInsets 
de la interfaz Border; este método devuelve un objeto de la clase Insets. He 
aquí el diagrama de herencia de la clase Insets: 
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Tabla 11.18. Métodos de la clase BorderFactory. 


Descripción 


static Border createBevelBorder(inttipo) 


static Border createBevelBorder(inttipo, 
Color highlight, Color shadow) 


static Border createBevelBorder(inttipo, 
Color highlightouter, Color highlightinner, 
Color shadowouter, Color shadowInner) 


static CompoundBorder create Com- 
poundBorderO 


static CompoundBordercreatecom- 
poundBorder(Border border, Border 
borde-— interior) 


static Border createEmptyBorder() 


static Border createEtchedBorder() 


static Border createEtchedBorder(Co1tor 
iluminación, Colorsombra) 


static Border createLineBorder(Co1 or 
color) 


static Border createLineBorder(Co1or 
color, int grosor) 


staticBorder createl oweredBevelBorder() 
static MatteBorder createMatteBorder(int 


superior, intizquierda, intfondo, intde- 
recha, Color color) 


Crea un borde biselado del tipo 
indicado. 


Crea un borde biselado del tipo, 
iluminación y sombreado indica- 
dos. 


Crea un borde biselado del tipo 
indicado, con los colores especifi- 
cados para las áreas internas y 
externas de iluminación y som- 
breado. 


Crea un borde compuesto. 


Crea un borde compuesto, indi- 
candolos objetos para los bordes 
interior y exterior. 


Devuelve un borde vacío que no 
ocupaespacio. Devuelve un borde 
vacío. 


Crea un borde como si fuera 
grabado usando el color de fondo 
actual del componente para la 
iluminación y el sombreado. 


Crea un borde como si fuera gra- 
bado usando los colores de ilumi- 
nación y sombreado. 


Devuelve una línea de borde con 
el color indicado. 


Devuelve una línea de borde con 
el color y grosor indicados. 


Devuelve un borde con un borde 
grabado más bajo. 


Devuelve un borde enmarañado 
usando un color sólido. 


Metodo Descripción 


static MatteBorder createMatteBorder Devuelve un border enmarañado 
(int superior, intizquierda, intfondo, hecho con múltiples azulejos de 
intderecha, /con tilelcon) un icono indicado. 


static Border createRaisedBevelBorder() Devuelve un borde con un borde 
biselado alzado. 


static TitledBorder create TitledBorder Devuelve un borde con un título 
(Border borde) vacío. 


static TitledBorder createTitledBorder Añade un título a un borde exis- 
(Border borde, String titulo) tente, indicando el texto del título. 


static TitledBorder create TitledBorder Añade un título a un borde, indi- 
(Border borde, Stringtitulo, intJustifi- cando el texto del título con su 
cacion-deltitulo, intPosicion-del-titulo) posición. 


static TitledBorder createTitledBorder Añade un título a un borde, indi- 
(Border borde, Stringtitulo, intJustifica- cando el texto del título con su 
cion-del-titulo, intPosicion-del-titulo, posición y fuente. 

Font Fuente-del-titulo) 


static TitledBorder createTitledBorder Añade un título a un borde, indi- 
(Border borde, Stringtitulo, intJustifica- cando el texto del título con su 
cion-del-titulo, intPosicion-del-titulo, posición, fuente y color. 

Font Fuente-deltitulo, colorColor-del- 

titulo) 


static TitledBorder create TitledBorder Creaun nuevotítulo, indicando el 
(String titulo) texto y usando las propiedades 
por defecto. 


booleanisBorderOpaque() Determina si el borde es opaco. | 


void paintBorder(Componentc, Graphics Pinta el borde del componente 
9, int X, int y, int anchura, int altura) especificado. 


Tabla 11.19. Métodos de la interfaz Border. 


Insets getBorderlnsets(Componenf c) Obtiene los insets del borde. | 


Los campos de la clase Insets se encuentran en la tabla 11.20, su construc- 
tor en la tabla 11.21 y sus métodos en la 11.22. 


Tabla 11.20. Campos de la clase Insets. 


Descripción 


int bottom Inset del fondo. 

int left Insetde la izquierda. 

int right Inset de la derecha. 

int top Insetde la parte superior. | 


Tabla 11.21. Constructor de la clase Border. 


Constructor 


Descripcion 


Insets(intsuperior, intizquierda, int Crea e inicializa un nuevo objeto 
fondo, intderecha) Insets. 


Tabla 11.22. Métodos de la clase Border. 


Método Descripción 

Object done() Crea una copia de este objeto. 
boolean equals(Objectobj) Verificasi dos objetosson iguales. 
String toString() Obtiene una representación en 


cadena de este objeto Insets. 


Veamos un ejemplo. En este caso, se añade un borde a JPanel usado en e” 
ejemplo de la applet hace algunos apartados. Para hacer eso, sólo usamos el 
método setBorder del panel (que tienen la mayoría de los componentes en 
Swing) y creamos un nuevo borde biselado alzado con el método 
createRaisedBevelBorder de la clase BorderFactory: 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 
import java.util.*; 


public class borde extends JApplet 
I 


jpanel j; 


public void init0 


( 


Container contentpane = getContentPane0; 


j = new jpanel0; 
3j.set-order (BorderFactory.createRaised8evelBorder-)); 
contentPane.adad (j); 
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Después de añadir un nuevo borde al panel, tomaremos los insets de este 
borde para dibujar en su interior el mensaje "¡HOladesde Swing!" sin solaparse 
con el borde. Para ello, usaremos el método getBorder para obtener el borde 
actual, el método getBorderInsets del objeto que soporta la interfaz Border, y 
el miembro de datos left de ese objeto para determinar dónde se empieza a 
pintar el mensaje para que no se solape con el borde: 


class jpanel extends JPanel 


public void paintcomponent (Graphics g) 
I 
g.drawString('"yBola desde úwingln, 
getBorder () .getBorderlInsete (this) .left. 60)j 


El resultado se muestra en la figura 11.3. Como se puede ver, el texto 
aparece en el interior del borde biselado que encierra el panel. Este ejemplo 
está en el CD como borde-java. 


[E änplei Viswa hmde lane 


¡Hola desde Swing! 


Figura 11.3. Añadir un borde a un objeto JPanei. 


Establecer la apariencia 


El gran jefe (Gj) regresa y dice, "Entiendo que no se puede establecer la 
apariencia de un programa Swing para relacionar varias plataformas de pro- 
gramación". "Es correcto”, le dice. BB pregunta, "¿Tiene algo en color cao- 
ba?" "Lo siento", le responde. 

Por defecto, la apariencia de los programas de Swing es la de Java Metal, 
la que Sun ha diseñado independiente de la plataforma. Sin embargo, se 
puede cambiar usando la clase UlManager. Este es el diagrama de herencia 
de esta clase: 


AVAN wing- UiManager 


El constructor de esta clase se encuentra en la tabla 11.23 y sus métodos 
en la 11.24. 

Para cambiar la apariencia cuando se está poniendo a punto un programa, 
se puede usar el método setLookAndFeelde la clase UIManager, pasándole 
uno de estos argumentos como una cadena: 


e javax.swing.plajmetal.MetalLookAndFeel ¿Apariencia de Metal. 
e com.sun.java.swing.pla“motifMotifLookAndFeeXpariencia de Mtif. 


* com.sun. java. swing. plafwindows.WindowsLookAndFeel ¡Apariencia de 
Windows. 


Tabla 11.23. Constructor de la clase UlManager. 
Constructor Descripción 


UlManager() Construye un nuevo objeto 
UlManager. 


Tabla 11.24. Métodos de la clase UlManager. 


Método Deseripción 
static void addAuxiliaryLookAndFee1 Añade un objeto LookAndFeel 


a la lista de apariencias. 


static void addpropertyChangeListener Añade un PropertyChangeLis- 
(PropertyChangeListener listener) tener. 


static Object get(Object key) Obtiene un objeto de la tabla 
por defecto. 


static LookAndFeel[] getAuxilizaryLook- 
AndFeelsO 

static Border getBorder(Object key) 
static Color getColor(Object key) 


static String getCrossPlatformLookAndFeel- 
ClassName() 


static UlDefaults getDefaults() 


static Dimension getdimension(Object key) 


| static Font getFont(Object key) 


static /con getlcon(Object key) 
static insets getInsets(Object key) 


static UlManager.LookAndFeellnfo[] get- 
InstalledLookAndFeels() 


static intgetInt(Object key) 


static LookAndFeel getLookAndFeel() 


static UlDefaults getLookAndFeelDefaults() 


static String getString(Object key) 


static String getSystemLookAndFeelClass- 
Name() 


Metodo Descripelón 


Obtiene la lista de aparien- 
cias. 


Obtiene un borde de la tabla 
por defecto. 


Obtiene un color para dibujar 
de la tabla por defecto. 


Obtiene el nombre de la clase 
LookAndFeel que soporta la 
apariencia independiente de 
la plataforma por defecto. 


Obtiene el defecto para esta 
apariencia. 


Obtiene una dimensión de la 
lista por defecto. 


Obtiene una fuente de la lista 
por defecto. 


Obtiene un icono de la lista 
por defecto. 


Obtiene un objetolnsetsde la 
lista por defecto. 


Obtiene un arrayde objetos 
que gestiona la información 
sobre la implementación 
LookAndFeelinstalada. 


Obtiene un entero de la lista 
por defecto. 


Obtiene la apariencia por 
defecto actual. 


Obtiene los valores por 
defecto de esta apariencia. 


Obtiene una cadena desde la 
lista de defectos. 


Obtiene el nombre de la clase 
LookAndFeelqueimplementa 
los sistemas nativos. 
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Descripcion 


static ComponentUl getUl(JComponent Obtiene la apariencia del ob- 
target) jeto que dibuja ei componente 
objetivo. 


static void installLookAndFeel(Stringnom- Crea una nueva apariencia y 
bre, Stringnombre—de—clase) la añade al array actual. 


static void installLookAndFeel(UlManager. Instala la apariencia especifi- 
LookAndFeelInfo info) cada. 


static Object put(Object key, Object valor) Almacena un objeto en los 
defectos. 


static boolean removeAuxiliaryLookAndFeel Elimina un objeto LookAnd- 
(LookAndFeellaf) Feel de la lista de apariencias. 


static void remove PropertyChangeListener Elimina un objeto Property- 
(PropertyChangeListenerlistener) ChangeListener. 


static void setInstalledLookAndFeels Reemplaza elarrayactual de 
(UlManager.LookAndFeelInfo[]infos) los objetos LookAndFeellnfo 
instalados. 


static void setLookAndFeel(LookAndFeel Fija la apariencia por defecto 
newLookAndFee1) actual con un objetoLookAnd- 
Feel. 


static void setLookAndFeel(String class- Fija la apariencia por defecto 
Name) actual con un nombre de una 
clase. 


Después de cambiar la apariencia del content pane, se puede hacer efecti- 
va con el método updateComponentTreeUT de la clase SwingUtilities, como 
sigue: 


SAtingUtilitiecs.updatecormpon8n tc Trecúl (grlContentPaned iii 


Este es un ejemplo en el que se añaden muchos controles Swing con los 
que ya hemos trabajado en un applet, por lo que se puede ver cómo aparecen 
con distintas apariencias. Hay tres botones de opción en estaapplet, etiqueta- 
das como Metal, Motify Windows, y cuando se hace clic sobre uno de los 
botones de opción, la applet cambia a la apariencia correspondiente. Este es el 
código(veremos cómo se usan todos estos controles en los siguientes capítulos): 

import java.awt.*; 


import javax.swing.*; 
import java.awt.event.*; 


import javax.swing.plaf.metal.MetalLookAndFeel; 
importcom.sun.java.swing.plaf.motif.MotifLookAnd-eel; 
import com.sun.java.-wing.plaf.wind-ws.WindowsLookAndFeel; 


public class plaf extends JApplet 
{ 


JRadioButton bl = new JRadioButton ("Metalm) 
b2 = new JRadioButton ("Motif"), 
b3 = new JRadioButton ("Windows"); 


public void inito0 

I 
Container contentpane = getContentPane0; 
contentPane.add (new jpanelo, BorderLayout.CENTER); 


} 


class jpanel extends JPanel implements ActionListener 
{ 
public jpanel() 
{ 
add (new JButton ("JBotón") 
add (new JTextField ("JCuadro-de-texto")); 
add (new JCheckBox ("JCasilla~deeactivación")); 
add (new JRadioButton ("JBotÓóÓn~de~opción")); 
add (new JLabel ("JEtiquetan); 
add (new JList(new String[l ( 
"JListaElemento 1", "JListaElemento 2"",JListaElemen- 


to 3))); 
add (new JScrollBar (SwingConstants.HORIZONTAL)); 


ButtonGroup group = new ButtonGroupo; 
group.add (b1); 
group .add (b2); 
group.add (b3); 


public void actionPerformed(ActionEvent e) 


{ 


JRadioButton src = (JRadioButton)e.getSourceo0; 


try 4d 
LEi(JiadioMoeson le. qetfourcel] == bl) 
TiManagor.2etcLookáindFwel | 
"jarax. seing: plai.oetal.MetalLookindFool*]; 
else ¡0811 fhediocbuitcón|e.gerScurtcelj == bli 
UiManager.secLockindFaal | 
“cop. sun. java. celo plai.motif.MocifLookindFuel*| y 
alae ¡£1(IEadiobutton e. petSourceli == HJI 
UIManagar. secLocokándFaul | 
"com.sun.java.swing.plaf.wind-w".Wind--sL--“kAndFeel"); 
1 


catch (Exception ex) () 


Ifingitilitias update ConpocráctTeas 01 |gatCostentPane li) 


La figura 11.4 muestra la applet con la apariencia Metal, la figura 11-15, 
la de Motify la 11.16, la de Windows .Cambiar entre estas apariencias es tan 
fácil como hacer clic sobre un botón de opción. Este ejemplo está en el CD 
como plaf.java. 
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Figura 11.5. Apariencia Motif. 
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Figura 11.6. Apariencia Windows. 


Establecer los componentes para la apariencia 


Dice el programador novato: "¿No sería maravilloso si todos los compo- 
nentes usaran las mismas fuentes y bordes?" "Bien", le contesta, "no estoy 
seguro de eso, pero se puede hacer en Swing". PN pregunta, "¿Usted sabe?" 

Se puede establecer la apariencia de los componentes individuales en 
Swing usando la clase LookAndFeel. Este es el diagrama de herencia de esta 
clase: 


A. awing-1 


El constructor de la clase LookAndFeel se encuentra en la tabla 11.25 y 
sus métodos en la 11.26. 


Tabla 11.25. Constructor de la clase LookAndFeel. 


Constructor Descripción 


LilDefaults gelDefanlis() Lo llama UlManager.setLookAnd- | 
Feel para crear los defectos de la 
apariencia. 


abstract String getDescription() Obtiene una descripción on line de 
esta implementación de la aparien- 
cia. 


abstract String getID() Obtiene una cadena que identifica 
esta apariencia. 


abstract String getName() Obtieneuna cadena corta que identi- 
fica esta apariencia. 


Constructor 


void initialize() 


static void installBorder(JComponent 
c, String defaultBorderName) 


static void installColors(JComponent 
c, String defauliBgName, String de- 
fauliFGName) 


static void installColorAndFont 
(JCom-ponentc, String defaultBg- 
Name, String defaultFoniName) 


abstract boolean isNativeLookAnd- 
Feel() 


Descripción 


UlManger.setLookAndFee lllama a 
este método antes de la primera lla- 
mada a getDefaults(). 


Instala un objeto Borderpor defecto 
del componente. 


Instala las propiedades del color de 
fondo y de primerplano de uncompo- 
nente con losvalores delos defectos 
actuales. 


Instala las propiedades de primer 
plano, fondo y fuente de los compo- 
nentes con valores por defecto. 


Si es verdadero, ésta es una imple- 
mentación de la apariencia nativa 
de la plataforma. 


abstract boolean is ~u ~ ~or ted ~ o &kes verdadero, la plataforma sub- 


AndFeel() 


static Object makelcon(Class base- 
Class, String gifFile) 


static JTextComponent.KeyBinding[] 
makeKeyBinding(Object[] keyBin- 
dinglist) 


String toString() 


void uninitialize() 


static void uninstallBorder(JCompo- 
nent c) 


yacente soporta y10 permite esta 
apariencia. 


Crea un UlDefaults.Lazy Value que 
crea un Imagelcon para el nombre 
gifFileindicado. 


Construye la lista de encuaderna- 
ciones clave. 


Obtiene una cadena que identifica 
las propiedades de este objeto. 


UlManager.setLookAndFeeTllama 
a este método justo antes de que se 
instale una nueva apariencia por 
defecto, reemplazando a ésta. 


Desinstala un borde por defecto del 
componente si el borde es una ins- 
tancia de UlResource. 


Veamos un ejemplo en el que se da la apariencia de una etiqueta Swing a 
un cuadro de texto, usando los métodos installBorder e installColorsAndFont 
de la clase LookAndFeel. Observe que todavía no se han visto funcionar estos 


controles formalmente; este ejemplo es sólo para indicar qué se puede hacer 
con estas apariencias. Crearemos una etiqueta Swing y una clase extendida 
desde la clase del cuadro de texto para que parezca una etiqueta. Este es el 
código: 

import java.awt.*; 

import javax.swing.*; 


lafeoaponente, clas 


public class plafcomponente extends JApplet 
{ 
public void init () 


{ 


Container contentpane = getContentPane0; 


JNewLabel jnewlabel = new JNewLabel ( 
"Esta es una etiqueta falsa."): 


content Pane. setLayout (new Flowlayout i] i+ 


contentPane.add (new JLabel ("Estaes una etiqueta real.")); 
contentPane.add (jnewlabel) ; 


class JNewLabel extends JTextField 


{ 
public JNewLabel (String S) 


I 
super (s); 
1 
public void updateUI0 
I 


super .updateUl (); 


sotHighlighter(a0111:; 
secEditabileltalsel: 


LookA4ndFeel.installBorderíthis, "Label, border") 


LooirAndFeel.installColorsAndFont (chia, *Labol. background", 
"Label, foreground", "Label. font" ji 


En la figura 11.7 se muestra el resultado. Como se puede ver en la figura, 
el cuadro de texto que aparece debajo de la etiqueta tiene la apariencia de una 


etiqueta. Esto le indica la potencia de la gestión de apariencias en Swing. 
Este ejemplo está en el CD como plafcomponente.java. 
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Figura 11.7. Establecer la apariencia de un cuadro de texto como si fuera una 
etiqueta. 


m Swing: 
Cuadros de texto, 
botones y 
casillas de 
activación 


Este capítulo se inicia con un debate sobre los controles Swing; en concre- 


to, revisaremos las etiquetas, botones, cuadros de texto, botones toggle, 
casillas de activación y botones de opción en Swing. Todos ellos son contro- 
les esenciales que ocupan gran parte de los fundamentos de Swing. A excep- 
ción de los botones toggle, todos estos controles le deberían resultar familiares 
de la programación AWT. Gran parte de la funcionalidad de estos controles 
Swing tiene su correspondencia en la de AWT, y aquí resaltaremos lo que es 
diferente. (Hay que tener en cuenta que todos los controles Swing aparecen de 
diferentes formas según las diversas apariencias; es importante recordar esto 
cuando se empiece a programar con ellos). 


Etiquetas y cuadros de texto 


Las etiquetas son controles básicos Swing que sólo visualizan una línea de 
texto. Sería razonable pensar que las etiquetas soportan varias líneas de texto 
en Swing, pero sólo soportan una. Por otro lado, soportan algo que no tienen 
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las etiquetas AWT: imágenes. Veremos cómo utilizar la claselmagelcon para 
añadir imágenes a las etiquetas. 

La gestión del texto en los componentes Swing es uno de los apartados que 
veremos más tarde en este libro. Ahora, iniciaremos este tema con los cua- 
dros de texto, viendo cómo funcionan en este capítulo y más adelante. 


Botones 


En Swing, cualquier botón se construye con la clase AbstractButton, y en 
este capítulo veremos esta clase. Como se podía esperar, los botones Swing 
tienen más capacidad que sus correspondientes en AWT, incluyendo la capa- 
cidad de visualizar imágenes, usar mnemónicos (combinación de teclas), 
diseñar un botón como botón por defecto de una ventana y fijar los márgenes 
y alineación del texto de un botón. Además, a un botón se le pueden asignar 
múltiples imágenes para gestionar el caso en que el ratón se mueva sobre el 
botón, y más cosas. Lo veremos a continuación. 


Botones toggle 


Swing introduce los botones toggle, que son botones que, cuando se hace 
clic sobre ellos, permanecen pulsados hasta que volvemos a hacer clic. Los 
botones toggle son como las casillas de activación y botones de opción que 
parecen botones estándar; de hecho, la clase JToggleButton, es la clase base 
para las clases de estos controles en Swing, y además se pueden instanciar 
objetos de esta clase directamente. Al igual que ocurre con las casillas de 
activación y botones de opción, se pueden agrupar botones toggle y usar 
imágenes en ellos. 


Casillas de activación y botones de opción 


AWT tiene casillas de activación y botones de opción, pero los gestiona de 
diferente forma que Swing. En Swing, los botones de opción tienen su propia 
clase (los botones de opción, son casillas de activación en AWT), y con ellos 
se pueden usar imágenes. De hecho, veremos que cuando se utilizan las 
imágenes con las casillas de activación y los botones de opción, hay algunos 
asuntos que considerar. 


Con esto finalizamos la visión rápida de lo que contiene este capítulo. 
Pasemos a la siguiente sección. 


Usar etiquetas 


El programador novato (PN) aparece y dice, "Estoy creando una nueva 
applet Swing y quiero poner etiquetas a sus controles, por ello estoy empe- 
zando con un objeto Label y..." "Un momento", le contesta. "Debería estar 
usando un objeto JLabel". PN dice, "Ah". 

La clase de las etiquetas peso pesado en Swing es JLabel. Este es el 
diagrama de herencia de esta clase: 


java. lang.Object 
Ijava.awt.Component 
ljava.awt.Container 
Ijavax.swing.JComponent 
Ijavax.swing.JLabel 


Los constructores de la clase JLabel se encuentran en la tabla 12.1 y sus 
métodos en la tabla 12.2. 


Tabla 12.1. Constructores de la clase JLabel. 


Constructor Descripción 
| JLabel Construye un objeto JLabel | 
sin imagen. 
JLabel(1conimagen) Construye un objeto JLabel 


con la imagen indicada. 


JLabel(lconimagen, intalineación—horizontal) Construye un objeto JLabel 
con la imagen y la alineación 
horizontal especificadas. 


JLabel(String texto) Construye un objeto JLabel 
con el texto indicado. 


JLabel(String texto, /conicono, intalinea Construye un objeto JLabel 
-ción-horizontal) con el texto, imagen y alinea- 
ción horizontal indicados. 


JLabel(Stringtext0,intalineación-horizontal) Construye un objeto JLabel 
con el texto y alineación hori- 
zontal indicados. 


E 


Tabla 12.2. Métodos de la clase JLabel. 


Método 


protected int checkHorizontalKey(int key, 


String mensaje) 


protected int checkVerticalKey(int mensaje) 


AccessibleContex! gelAccessible Context 


Icon gellDisabledicon( 


intgetDisplayedMnemonic() 


intgetHorizontalAlignment() 


intgetHorizontalTextPosition() 


icon gelícan” 


int getlcon TextGap() 


Component getLabelFor() 


String getText() 
LabelUl getUl() 


String getUlClassID() 


Descripción 


Verifica un valor para las pro- 
piedades de alineación hori- 
zontal. 


Verifica un valor para la pro- 
piedad alineacióno la posición 
de texto verticales. 


Obtiene el contextoaccesible. 


Obtiene el valor de la propie- 
dad disabledlcon si se ha 
establecido. 


Obtiene el código de la tecla 
que indica un mnemónico. 


Obtiene la alineación de los 
contenidos de la etiqueta a lo 
largo del eje x. 


Obtiene la posición horizontal 
del texto de la etiqueta, rela- 
tivo a su imagen. 


Obtiene la imagen gráfica 
(alypho icono) que visualiza 
la etiqueta. 


Obtiene la cantidad de es- 
pacio entre el texto y el icono 
visualizados en la etiqueta. 


Obtiene el componente del 
objeto thispara el que es esta 
etiqueta. 


Obtiene la cadena de texto 
que visualiza la etiqueta. 


Obtiene la apariencia que tie- 
ne este componente. 


Obtiene una cadena que 
indicael nombrede la aparien- 
cia de la clase de este compo- 
nente. 


Método De scripelón 


int getVerticalAlignment() Obtiene la alineación de los 
contenidos de esta etiqueta a 
lo largo del eje y. 


intgetVerticalTextPosition() Obtiene la posición vertical 
del texto de la etiqueta, 
relativo a su imagen. 


protected String paramString() Obtiene una representación 
en cadena de este objeto 
JLabel. 

void setDisabledlcon(Iconicono-deshabi-  Fijaelicono quese vaa visua- 

litado) lizar si este objetoJLabelestá 


deshabilitado. 


void setDisplayedMnemonic(char aChar) Especifica el mnemónico | 
visualizado como un carácter. 


void setDisplayedMnemonic(intkey) Especifica el código de tecla | 
que indica un mnemónico. 


void setHorizontalAlignment(intalineación)  Fijalaalineación de los conte- | 
nidos de la etiqueta a lo largo 


del eje x. 
void setHorizontalTextPosifion(intposi- Fijala posición horizontal del 
ción-deltexto) texto relativo a su imagen. 
void setlcon(Icon icono) Define elicono que visualizará 


este componente. 


void setlcon TextGap(int icon TextGap) Si el icono y las propiedades | 
del texto están establecidas, | 
esta propiedad define el espa- 
cio entre ellas. 


void setLabelFor(Component c) Fija el componente que este 
objeto está etiquetando. 


void setText(String texto) Define la línea de texto que 
este componente visualizará. | 


void setUl(LabelU1 ui) Fija la apariencia del objeto 
de este componente. 


void setVerticalAlignment(intalineación) Fijala alineación delos conte- 
nidos de esta etiqueta a lo lar- 
go del eje y. 


Método Descripción 


void setVerticalTextPosition(intposición= Fija la posición vertical del 
del-texto) texto relativo a la imagen. 


void updateUlI() Lo llama la clase UlFactory 
cuando la apariencia ha cam- 
biado. 


A continuación tenemos un ejemplo básico que muestra cómo se crea una 
etiqueta Swing con el texto "¡Hola desde Swing": 


import java.awt.*; 
import javax.swing.”; 


iqueta.claña 
A 


HEIGHT=300 
APPLE T> 


public class etiqueta extends JApplet 


{ 
public etiqueta0 


‘ Container contentpane = getContentPane0; 
JLabel jlabel = new JLabel Í- ;Hola desde Swing!"); 
contentPane.setLayout [new FlowLayout ii); 
content Pene. adil jlabeli 


1 
f 


El resultado de este código se muestra en la figura 12.1; este ejemplo se 
encuentra en el CD que acompaña a este libro como etiqueta-java. 


| FH hnis Bima Abii ien 


Figura 12.1. Una etiqueta Swing. 


Hay muchas cosas que se pueden hacer con las etiquetas Swing. Por 
ejemplo, se puede fijar la alineación del texto en una etiqueta, así como 
utilizar imágenes. Veremos todas las posibilidades en un par de secciones. 
Para visualizar una imagen en una etiqueta, se necesita un objeto que 
implemente la interfaz Icon (encontrará sus métodos en la tabla 12.3). 

Afortunadamente, en Swing hay una forma fácil de crear iconos desde las 
imágenes: se puede usar la clase Irnagelcon, como se ve en el siguiente punto. 


Tabla 12.3. Métodos de la interfaz Icon. 


Método Descripción 
intgetlconHeight() Obtiene la altura del icono. 
int getlcon Width() Obtiene la anchura del icono. 
void paintlcon(Component c, Gra- Dibuja el icono en la posición indi- 
phics g, int x, int y) cada. 


Usar iconos imagen 


"Heyl', dice el programador novato, "ya eché un vistazo a la interfaz Icon. 
¿Tengo que pintar las imágenes en los iconos yo mismo cuando utilizo 
Swing?" "Por supuesto que no", le dice. "Se puede utilizar la clase Imagelcon 
para hacer las cosas más fáciles". "Cuénteme todo sobre esto", dice NP. 

La clase Irnagelcon permite crear un icono desde un fichero de imagen 
para utilizarlo en un control Swing. Este es el diagrama de herencia de esta 
clase: 


2643. 1Imagelcor 


Los constructores de la clase Imagelcon se encuentran en la tabla 12.4 y 
sus métodos en la 12.5. 


Tabla 12.4. Constructores de la clase /magelcon. 


Constructor Descripción 
Imagelcon() Construye un icono imagen. 
Imagelcon(byte[] imageData) Construye un icono imagen desde 


un array de bytes. 


Imagelcon(byte[] ImageData, String Construye un icono imagen desde 
descripción) un arrayde bytes que se leyó de un 
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Constructor 


Imagelcon(Image imagen) 


Imagelcon(Image imagen, String 
descripción) 


Descripción 


fichero imagen que contiene un for- 
mato de imagen soportado. 


Construye un icono imagen desde 
un objeto imagen. 


Construye un icono imagen desde 
la imagen dada. 


Imagelcon(Stringnombre_defichero) Construye un icono imagen desde 


el fichero dado. 


Imagelcon(Stringnombre_de_fichero, Construye un icono imagen desde 


Stringdescripción) 
Imagelcon(URL posición) 


Imagelcon(URL posición, String 
descripción) 


el fichero dado. 


Construye un icono imagen desde 
la URL indicada. 


Construye un icono imagen desde 
la URL indicada. 


Tabla 12.5. Métodos de la clase Imagelcon. 


Método 


String getDescription() 
intgetlconHeight() 
intgetlconWidth() 

Image getlmageo 
intgetlmageLoadStatus() 


Descripción 
Obtiene la descripción de laimagen. 
Obtiene la altura del icono. 
Obtiene la anchura del icono. 
Obtiene la imagen del icono. 


Obtiene el estado de la operación 
de carga de imagen. 


ImageobservergetimageObserver() Obtiene el image observer de la 


protected void loadlmage(Image 
imagen) 


void painticon(Component c, Gra- 


| phics g, intx inty) 


imagen. 


Espera a que se cargue la imagen. 


Pinta el icono. 


voidsetDescription(Stringdescripción) Fija la descripción de la imagen. 


void setimage(1mage imagen) 


void setlmageObserver(Image0b- 
server observer) 


Fija la imagen visualizada por este 
icono. 


Fijael imageobserverparalaimagen. 


La clase ImageZcon es extremadamente útil en Swing, porque muchos 
componentes Swing pueden visualizar iconos. En el siguiente apartado vere- 
mos esta clase funcionando. 


Usar imágenes en etiquetas 


El gran jefe (GJ) aparece y dice: "Necesitamos que las cosas sean un poco 
más atractivas en nuestros programas, porque ahora, la competencia dentro 
del campo de GUI es muy fuerte". "De acuerdo", le contesta, "podemos 
añadir iconos de imágenes a cada etiqueta". "Bien", dice Gj, "su nuevo 
código era para ayer". 

Se pueden utilizar varios constructores JLabel para añadir imágenes a las 
etiquetas, y se puede especificar la alineación de las imágenes y del texto con 
métodos como estos: 


e setVerticalTextAlignment: Fija la alineación vertical del texto relativo a 
la imagen. 


e setHorizontalTextAlignment: Fija la alineación horizontal del texto 
relativo a la imagen. 


e setVerticalAlignment: Fija la alineación vertical de los contenidos de la 
etiqueta. 


e setHorizontalAlignment: Fija la alineación horizontal de los contenidos 
de la etiqueta. 


Para especificar las alineaciones se pueden utilizar constantes como estas: 
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NORTH, 
NORTH-EAST, NORTH-WEST, RIGHT, SOUTH, SOUTH-EAST, 
SOUTH-WEST, TOP, TRAILING, VERTICAL y WEST. 

A continuación tenemos un ejemplo en el que se añade una etiqueta con 
una imagen y texto a un applet. El texto estará centrado debajo de la imagen. 
Para crear la imagen, usamos la clase Imagelcon, pasando al constructor de 
esa clase el nombre del fichero que gestiona la imagen que queremos usar 
(que, en este caso, es etiqueta-jpg): 


import java.awt.*; 
import javax.swing.*; 
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public class etiquetaimagen extends JApplet 


public void initoO0 


{ 


Container contentpane = getContentPane0; 


JLabel jlabel = newJZabel ("Etiquetan. new~mage~con (~etiqueta.jpg~), 
JLabel-CENTER) ; 
Jiabel :setVarticalTestřosition{JLabeal : BOTTOM) 
jlabel .setHorisontalTeatFositionįJLabel ,CENTER )} p 


El resultado se muestra en la figura 12.2, y este ejemplo se encuentra en el 
CD como etiquetaimagen-java. Observe lo fácil que es añadir imágenes a las 
etiquetas en Swing. Como es muy sencillo, es muy común. 


Beki Vasa pina Edd 


Tikpeës 


Figura 12.2. Una etiqueta Swing con una imagen. 


Usar cuadros de texto 


"No me lo diga", dice el programador novato, "creo que acertaré el nom- 
bre de la clase de Swing para los cuadros de texto: JTextField, ¿es correcto?" 
"Exactamente", le sonríe. 

Por compatibilidad, los cuadros de texto en Swing funcionan como en 
AWT, con algún valor añadido. Este es el diagrama de herencia de la clase 
JTextField: 


500 


mir swing: JTextField 


Más adelante en este libro, veremos más cosas sobre los componentes de 
texto Swing, pero por ahora, introduciremos la clase JTextField para que 
podamos obtener entradas del usuario antes de ese momento. Los constructo- 
res de la clase JTextField se encuentran en la tabla 12.6 y sus métodos en la 
12.7. 


Tabla 12.6. Constructores de la clase JTextField. 


Constructores Descripción 

JTextFieldO Construye un nuevo cuadro de texto. 
JTextField(Document doc, String Construye un nuevoobjeto JTextField 
texto, intcolumnas) que usa el modelo de almacena- 


miento y las columnas dados. 


JTexiFieidint cumas) Construye un nuevo cuadro de texto 
vacío con el texto indicado. 


JTextField(String texto, intcolumnas) Construye un nuevo cuadro de texto 
inicializado con el texto y columnas 
indicados. 


Tabla 12.7. Métodos de la clase JTextField. 


Método Descripción 


void addActionListener(ActionListenerl) Añade el action listener para 
obtener eventos de acción desde 
este cuadro de texto. 


protected Document createDefault- Construye la implementación, por 
Modelo defecto, del modelo. 


portected void fireActionPerformedo Notifica a los listenersque tiene es- 
te tipo de evento. 


AccessibleContext getAccessible Obtiene el contexto accesible. 

Contexto 

Acho gelActionsí Obtiene la lista de comandos para el 
editor. 

int getColumns() Obtiene el número de columnas. 

protected int getcolumn Width() Obtiene la anchura de la columna. 


Método 


int getHorizontalAlignment() 


BoundedRangeModelgetHorizontal- 
Visibility () 
Dimension getPreferredSize() 


int getScrollOffset() 
String getUlClassID() 
boolean isValidateRoot() 


protected String paramString() 


void positionActionEvent() 


void removeActionListener(Action 
Listener 1) 


void setActionCommand(Stringco- 
mando) 


void setColumns(int columnas) 
void setFont(Font f) 


void setHorizontalAlignment(intali- 
neación) 


void setScrollOffset(int scrollOffset) 


void scrollRectToVisible(Rectangle r) 


Descripción 


Obtiene la alineación horizontal del 
texto. 


Obtiene la visibilidad del cuadro de 
texto. 


Obtienelas dimensiones preferidas 
necesarias para este cuadro de 
texto. 


Obtiene elofftsetdedesplazamiento. 
Obtiene la clase ID para un Ul. 


Vuelve a validar las llamadas que 
vienen desde el cuadro de texto y 
que serán gestionadas para validar 
el nuevo cuadro de texto. 


Obtiene una representación en 
cadena de este cuadro de texto. 


Procesa eventos de acción que 
ocurren en este cuadro de texto 
enviándolos a cualquier objeto 
ActionListenerregistrado. 


Elimina el action listenerindicado. 


Desplaza el campo a la izquierda o 
derecha. 


Fija la cadena del comando usada 
para eventos de acción. 


Fija el numero de columnas. 
Fija la fuente actual. 


Fijala alineación horizontaldel texto. 


Fija el offsetde desplazamiento. 


Este es un ejemplo rápido que sólo visualiza un cuadro de texto con el 


texto '"'¡Holadesde Swing!": 


import java.awt.*: 
import javax.swing.*; 


public class cuadrodetexto extends JApplet ( 
JTextField text = new JTextField(20); 


public void inito0 


{ 


Container contentpane = getContentPane0; 


contentPane.setLayout (new FlowLayoutoO); 
contentPane.add (text1; 
text.setText ("iHoladesde Swing!"); 


1 


El resultado de este código, cuadrodetexto.java en el CD, se muestra en la 
figura 12.3. 

Esto es sólo el comienzo en la utilización de los componentes de texto en 
Swing, pero nos permite empezar y nos proporciona una forma fácil de 
visualizar la salida de nuestros programas. Por ejemplo, en los siguientes 
apartados conectaremos un cuadro de texto a un botón. 


Jl] 
Arii 


/,Hola desde wr! 


Figura 12.3. Un cuadro de texto Swing. 


Abstract Button: base de los botones Swing 


"Pero no quiero usar la clase AbstractButton "dice el programador nova- 
to. "Quiero utilizar la clase JButton. ¿Por qué tengo que saber nada sobre 


B4 


AbstractButton?" "En Swing, todos los botones se derivan de AbstractButton ", 
le dice, "y hay un número tremendo de métodos en esa clase que debería 
conocer, únicamente como referencia. Realmente, será bueno para usted". 
"Ah", dice PN. 

La clase AbstractButton es la base de las clases de botones en Java, y al 
igual que JComponent, proporciona muchos métodos que no podemos igno- 
rar. Este es el diagrama de herencia de AbstractButton: 


A ri Component 
JÄN 
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Los campos de esta clase se encuentran en la tabla 12.8, su constructor en 
la 12.9 y sus métodos en la 12.10. 


Tabla 12.8. Campos de la clase JAbstractButton. 


protected ActionListener actionlistener 


static String BORDER-PAINTED-CHAN- 
GED -PROPERTY 


protected ChangeEvent changeEvent 


protected ChangeListener changeListener 


static String CONTENT-AREA-FILLED- 
CHANGED-PROPERTY 


static String DISABLED-ICON-CHAN- 
GED -PROPERTY 


static String DISABLED-SELECTED- 
/CON-CHANGED-PROPERTY 


static String FOCUS-PAINTED-CHAN- 
GED -PROPERTY 


static String HORIZONTAL-ALIGNMENT- 
CHANGED-PROPERTY 


Descripción 
Action listener. 


Indica un cambio al borde. 


El cambio de evento del botón. 


Los modelos de listeners del 
botón. 


Indicaun cambiode habilitado 
adeshabilitado o volver a ha- 
bilitado. 


Indica un cambio del icono 
mostrado cuando el botón se 
ha deshabilitado. 


Indica un cambio del icono 

mostrado cuando el botón se 
ha deshabilitado y seleccio- 
nado. 


Indica un cambio para tener 
el borde iluminado cuando se 
tiene o no el foco. 


Indica un cambio en la ali- 
neación horizontal del botón. 


Campo Descripción 


static String HORIZONTAL-TEXT-POSI- Indica un cambio en la posi- 
TION-CHANGED-PROPERTY ción horizontal del texto del 
botón. 


static String /(CONCHANGED- PROPERTY Indica un cambio en el icono 
que representa el botón. 


protected ltemListener ¡temListener El ¡temListenerde estebotón. 

static String MARGIN-CHANGED-PRO- Indica un cambio en los már- 

PERTY genes del botón. 

static String MNEMONIC-CHANGED- Indica un cambio en el nemó- | 

PROPERTY nico del botón. 

protected ButtonModelmodelo Modelo de datos que determi- 
na el estado del botón. 

static String MODEL-CHANGED-PRO- Indica un cambio enel modelo 

PERTY del botón. 

static String PRESSED-ICON-CHAN- Indica un cambio en el icono 

GED-PROPERTY cuando el botón se ha presio- 
nado. 

static String ROLLOVER-ENABLED- Indicaun cambio enla proprie- 

CHANGED-PROPERTY dad "rolloverenab1ed"debotón. 

static String ROLLOVER-ICON-CHAN- Indica un cambio en el icono 

GED- PROPERTY cuando el cursor está sobre 
el botón. | 

static String ROLLOVER-SEL ECTED- Indica un cambio en el icono | 

/CON-CHANGED-PROPERTY cuando el botón estaseleccio- 
nado y el cursor sobre el 
botón. 

static String SELECTED-ICON-CHAN- Indica un cambio en el icono 

GED-PROPERTY cuando se ha seleccionado el 
botón. 

static String TEXT-CHANGED- PROPERTY Indica un cambio en el texto 
del botón. 

static String VERTICAL-ALIGNMENT- Indica un cambio enla alinea- 

CHANGED-PROPERTY ción vertical del botón. 

static String VERTICAL -TEXT-POSITION- Indica un cambio en la posi- 

CHANGED-PROPERTY ción vertical del texto del 
botón. 
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Tabla 12.9. Constructor de la clase AbstraciButton. 


Constructor Descripción 
AbstraciBution() Construye un nuevo objeto 
AbstractButton. 


Tabla 12.10. Métodos de la clase AbstractButton. 


Método Descripción : 
void addActionListener(ActionListener 1) Añade un action listener. 


void addChangeListener(ChangeListener ) Añade un change listener 


void addltemListener(itemListener 1) Añade un ¡tern listener a una 
casilla de activación. 


protected int checkHorizontalKey(int pro- Verifica que keyes un valor 


perkey, Stringexcepción) legal para la alineación hori- 
zontal. 

protected int checkVerticalKey(int key, Verifica que keyes un valor 

| String excepción) legal para las propiedades de 


alineación vertical. 


protected ActionListener createActionLis- Crea un action listener. 
tener() 


| protected ChangeListener createlmple- Sobrescribeeste método para 
rnentationChangeL istener() devolverotro ChangeListener. 


protected ltemListener createlternListener() Crea un itern listener. 


void doClick() Hacer clic enel botón de forma 
| programada. 
| void doClick(int pressTime) Hacer clic sobre el botón en 


un tiempo determinado de 
forma programada. 


protected void fireActionPerformed(Action Lanza un evento de acción. 
Event event) 


| protected void fireltemStateChanged(item Lanza un evento de elemento 


Event event) cambiado. 
| protected void fireStateChanged0 Lanza un evento de estado 
| cambiado. 

String getActionCornmand() Obtiene el comando deacción 


para este botón. 


Método 


icon gelDisabledicon 


icon golDisabledSelectod icon) 


| intgetHorizontalAlignment() 


intgetHorizontalTextPosition() 


/con geticon() 
String getLabel() 


Insets getMargin() 


intgetMnemonicO 


ButtonModel getModel() 
Icon getPressedicon() 


Icon getrolloverlcon() 
/congetrolloverSelectedlcon() 


Icon getSelectedicon() 


Objeci[] gelSelecieo Objects) 


String getText() 
ButtonUl getUl() 
int get VerticalAlignment() 


int getVerticalTextPosition() 


Descripelón 


Obtiene el icono deshabilita- 
do. 


Obtiene eliconoseleccionado 
deshabilitado. 


Obtiene la alineación horizon- 
tal del icono y del texto. 


Obtiene la posición horizontal 
del texto relativo al icono. 


Obtiene el icono por defecto. 


Obsoleto. Reemplazado por 
getText(). 


Obtiene el margen entre el 
borde del botón y la etiqueta. 


Obtiene el mnemónico del 
t e c | a - 
do del modelo actual. 


Obtiene el modelo que repre- 
senta este botón. 


Obtiene el icono presionado 
para el botón 


Obtiene el icono del botón. 


Obtiene el icono seleccionado 
del botón. 


Obtiene el icono seleccionado 
para el botón. 


Obtiene un array de longitud 
1 que contiene la etiqueta o 
nulo si el botón no está 
seleccionado. 


Obtiene el texto del botón. 
Obtiene el Ulactual del botón. 


Obtiene la alineación vertical 
del texto y del icono. 


Obtiene la posición vertical 
del texto relativa al icono. 
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Metodo 


Descripción 


protected void init(String texto, /conicono) 
| boolean isBorderPainted() 


boolean is ContentAreaFilled() 
boolean isFocusPainted() 
boolean i¡sRolloverEnabled() 
boolean is Selectedo 


protected String paramStringO 


void removeActionListener(ActionListenerl) 


Para uso interno. 


Determinasise debería pintar 
el borde. 


Verifica si se debería rellenar 
eláreade contenidodel botón. 


Determinasi se deberíapintar 
el foco. 


Verifica si los efectos derollo- 
ver están activados. 


Obtiene el estado del botón. 


Obtiene una representación | 
en cadena de este objeto 
AbstractButton. 


Elimina un action listener. 


~oidremoveChangeListener(ChangeListenerl) Elimina un change listener. 


void removeltemL istener(ltemListener 1) 


void setActionCommand(String action- 
Commana) 

void setBorderPainted(boo1eanb) 

void setContentAreaFilled(booleanb) 
void setDisabledlcon(Icon disabledlcon) 
void setDisabledSelectedlcon(icon disa- 
bledSelectedlcon) 

void setEnabled(boo1eanb) 

void setFocusPainted(boo1eanb) 


void setHorizontalAlignment(intalineación) 


void setHorizontalTextPosition(int textPosition) 


Elimina un ¡tem listener. 
Establece el comando de 
acción. 


Fija si se debería pintar el 
borde. 


Especifica si el botón debería 
pintar el content area. 


Fija el icono deshabilitado 
para el botón. 


Fija el icono seleccionado 
deshabilitado para el botón. 


Habilita (o deshabilita) el bo- 
tón. 
Fija si se debería pintar el 
foco. 


Fija la alineación horizontal 
del icono y del texto. 


Fija la posición horizontal del 
texto relativa al icono. 


void seticon(icon defaulticon) Fija el icono por defecto del | 
botón. 

void setLabel(Stringetiqueta) Obsoleto. Reemplazado por 
setText(text0). 

void setMargin(1nsets m) Fija el espacio para los márge- 
nes. 

void setMnemonic(char mnemonic) Especificael valor mnemónico. 

void setMnemonic(int mnemonic) Fija el mmemónicodel teclado. 

void setMode(ButtonMode Inuevo-modelo) Fija el modelo que representa 
este botón. 

void setPressedlcon(Icon pressedlcon) Fija el icono presionado. 

void setRolloverEnabled(boo1eanb) Fija si se deberían habilitar 
los efectos de rollover. 

void setRolloverlcon(Icon rolloverlcon) Fija el icono rollover para el 
botón. 

void setRolloverSelectedlcon(Iconrollover- Fija elicono seleccionado ro- 

Selectedlcon) lloverpara el botón. 

void seiSelected(boo tean b) Fija el estado del botón. 

void setSelectedlcon(1conselectedicon) Fija el icono seleccionado 
para el botón. 

void setText(String texto) Fija el texto del botón. 

void setUl(ButtonU1 uj) Fija el Ul del botón. 


void setVerticalAlignment(intalineación) Fija la alineación vertical del 
icono y del texto. 


void setVerticalTextPosition(intoosición= Fija la posición vertical del 


deltexto) texto relativa al icono. 

void updateUl() Obtiene un nuevo objeto Ul 
desde la clase por defecto 
UlFactory. 


Usar botones 
El programador novato llega y dice: "Estoy preparado para empezar a 


trabajar con botones Swing. ¿Qué hacen?" "Hmm", le contesta, "¡bastantes 
cosas! Mejor tome asiento". 


La clase JButton soporta los botones Swing. Este es el diagrama de 
herencia de esta clase: 


Los botones Swing permiten hacer más cosas que los botones AWT. Algu- 
nas de estas cosas incluyen el uso de setToolTipTextpara añadir un tooltip al 
botón, usar setMargin para fijar losinsets del mismo botón, usardoclickpara 
hacer clic en el botón desde el código, añadir imágenes al botón y añadir 
mnemónicos (combinación de teclas) para el botón. Por supuesto, se pueden 
hacer cosas estándar de AWT con JButton, como usar setEnabled para habili- 
tar o deshabilitar el botón, usar addActionListener para registrar un action 
listener con el botón y añadir comandos de acción a objetos JButton con 
setActionCommand. -. 

Los constructores de la clase JButton se encuentran en la tabla 12.11 y sus 
métodos en la 12.12. 

Observe que esta clase se basa en la clase AbstractButton, lo que quiere 
decir que hereda toda su funcionalidad (ver el punto anterior para más deta- 
lles). 


Tabla 12.11. Constructores de la clase JButton. 


Constructor Descripción 

JButton() Construye un botón. 

JButton(?conicono) Construye un botón con un ¡conó. 

JButton(String texto) Construye un botón con el texto 
dado. 

JBotton(String texto, /conicono) Construyeunbotón contexto e icon. 


Tabla 12.12. Métodos de la clase JButton. 


Descripción 


AccessibleContextgetAccessible- Obtiene el contexto accesible. 
Contexto 
String getUlClassla() Obtiene una cadena que indica el 


nombre de la apariencia. 


Método Descripción 


boolean isDefaultButton() Indica si este botón es el botón por 
defecto en el root pane. 


boolean isDefaultCapable() Indica si este botón es capaz de ser 
el botón por defecto del root pane. 


protected String paramString() Obtiene una representación en ca- 
dena de este objeto JButton. 


void setDefauliCapable(booleande- Especifica si este botón es capaz de 
faultcapable) serelbotón por defectodel rootpane. 


void updateUl() Llamado por la clase UlFactory 
cuando cambia la apariencia. 


Veamos un ejemplo en el que está funcionando la clase JButton. Aquí se 
visualiza el mensaje "¡Hola desde Swing!" cuando el usuario hace clic sobre 
un botón. Este ejemplo, (en el CD botón.java), es muy sencillo, como se 
puede ver en el siguiente código: 


import java.awt.*; 
import jJavax.swing.*; 
import jJava.awt.event.*; 


public class boton extends JApplet ( 
JButton button = new JButton ("Haga clic aquí"); 
JTextField text = new JTextField(20); 


public void initoO 


{ 


Container contentpane = getContentPane0; 


content Panra. add {bution | 


button.addllctionListener (new ActionListenerO 
r 


public void actionPerfomed (ActionEvent event) { 
text .setText (“iHoladesde Swing!"); 
2 


dor 


El resultado de este código se muestra en la figura 12.4. Como se puede 
ver, cuando el usuario hace clic sobre el botón, la applet visualiza su mensaje 
en el cuadro de texto. 

Hay mucho más que hacer con los objetos JButton, veremos todas las 
posibilidades en los siguientes apartados. 
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Figura 12.4. Usar un botón Swing. 


Visualizar imágenes en botones 


"Sé que se pueden visualizar imágenes en etiquetas Swing", dice el pro- 
gramador novato, "pero jse pueden visualizar en botones?" "No hay ningún 
problema", le dice, "basta con tener un objeto Icon". 

Es fácil visualizar imágenes en botones usando la clase Imagelcon, ya que” 
varios constructores JButton permiten añadir iconos a los botones. Además 
se puede establecer la alineación del texto y de la imagen usando los métodos 
AbstractButton siguientes: 


e setVerticalTextAlignment: Fija la alineación vertical del texto relativo 4 
la imagen. 


e setHorizontalTextAlignment :Fijala alineación horizontal del texto rela- 
tivo a la imagen. 


* setVerticalAlignment: Fija la alineación vertical de los contenidos del 
botón. 


e setHorizontalAlignment: Fija la alineación horizontal de los contenidos 
del botón. 


Veamos un ejemplo en el que se añade una imagen desde el archivo 
boton'jpg al ejemplo del botón del apartado anterior: 
import java.awt.*; 


import javax.swing.*; 
import java.awt.event.*; 


class 


public class botonimagen extends JApplet { 
JButton button = new JB~tton (~Botón"ņew ImageI~on (~boton.jpor) 
JTextField text = new JTextField (20); 
public void kit () 


Container contentpane = getContentPane0; 


cantant Pane. setLayont (or FlowLayont |} pi 
nbentPane. add button; 
contentPFane. add lEesxtbl; 


button.add-ctionListener (newActionListenero 


public void actionPerformed(ActionEvent event) ( 
text .setText (" ¡Hola desde Swing!"); 


El resultado se muestra en la figura 12.5. Como se puede ver ahora, el 
botón visualiza una gran imagen, haciendo que el programa sea visualmente 
más interesante. Este ejemplo está en el CD como botonimagen.java. 
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Figura 12.5. Usar un botón Swing con una imagen. 


Usar imágenes rollover y deshabilitadas 


El gran jefe está aturullado y dice, "¡Tenemos que alegrar nuestros progrfl 
mas!" "De acuerdo", le dice, "puedo añadir imágenes rollover con los boto- 
nes para que se visualice una imagen cuando el ratón se mueva sobre ellos. 
Hasta ahora, ¿por qué no hemos animado las cosas?" "Porque", dice el gran 
jefe, "nuestros competidores han invertido años de trabajo y dinero para 
hacer que sus programas sean el doble de útiles que los nuestros”. "¿No 
deberíamos hacer nosotros lo mismo?", le pregunta. El GJ dice, "No sea 
ridículo”. 

Para los botones se puede establecer un número de iconos. Estas son la? 
posibilidades (iconos rollover que aparecen cuando se mueve el ratón sobre 
el botón): 


e Icono normal. 

* Icono rollover. 

e Icono seleccionado rollover. 

e Icono seleccionado. 

e Icono presionado. 

e Icono deshabilitado. 

e Icono seleccionado deshabilitado. 

En el siguiente ejemplo veremos todas estas posibilidades funcionandg 
(en el CD es el archivo botoniconos.java). Para instalar todos estos iconos, ı 
usamos un método con el nombre correspondiente: setlcon, setRolloverlcon, ' 
setRolloverSelectedIcon,setSelectedicon, setPressedicon, setDisabledlcon Y , 


setDisabledSelectedlcon. Aquí tenemos el código (observe que para habilitar 10s 
eventos rollover, llamamos a setRolloverEnabled con un valor verdadero): 


import java.awt.*; 
import javax.swing.*; 


public class botoniconos extends JApplet 


public void inito0 
i Container contentpane = getContentPane0; 
Icon normal = new ImageI~on (~normal.jpg~); 
Icon rollover = new ImageIcon (nrollover.jpgm); 
Icon pressed = new Imagelcon ("pulsado.jpg"); 
Icon disabled = new ImageI~on (~deshabilitado~jpg~); 
Icon selected = new ImageIcon ("seleccionado.jpgn) ; 
Icon rolloverSelected = new 
~mageIcon (~reseleccionado. jpg"); 
Icon disabledselected = new 
~mage~con (~deseleccionado. jpg"); 


JButton jbutton = new JButtonO; 
jbuttor at liov"arEnabl 


Jbutten. satlcon(sormal]j 

button. setRolloverioonirollover]j 
itatton.sstPRolloresialectedicon(rollovarielected]; 
jbutton setelectólicon(salected); 
ibuttos.sotPrescedlcon presred!; 
jbutton.sstDissblediconidisabledi; 
Jbutton.sstolsmabledialeactadicos(dislbledialected):; 


El resultado se muestra en la figura 12.6. Cuando el ratón se mueve sobre 
el botón, la imagen rolloverestá visible. 


Figura 12.6. Usar imágenes rollover y otras en un botón. 


Botones por defecto y mnemónicos 


Si echa un vistazo a los cuadros de diálogo de su sistema operativo, verá 
que, generalmente, hay un botón marcado como botón por defecto y ese 


botón automáticamente es pulsado si el usuario ejecuta alguna acción con el' 
teclado, como es pulsar la tecla Intro. Con Swing se puede poner un botón por 
defecto usando el método setDefaultButton. 

Además de hacer botones por defecto, se puede dar a cada botón un 
mnemónico, que es la combinación de teclas cortas, como se puede ver en los 
menús. Se subraya una letra (no sensible a mayúsculas y minúsculas) en el 
texto del botón, y cuando tiene el foco, al pulsar ese carácter el botón se 
activa. Si el botón no tiene nombre, pulsando la meta tecla (por ejemplo, la 
tecla Alt en Windows) y el mnemónico del botón lo activa. B 

Veamos esto en el código. En este caso, se añaden dos botones a un applet 
y se hace que el segundo sea el botón por defecto. Este botón tendrá el literal 
"Haga clic aquí", y haremos que la letra H sea el mnemónico. Así se haría en 
el código (observe que damos el foco al root pane al final del código para que 
se puedan interceptar los eventos de tecla y así se active el botón por defecto 
cuando el usuario pulse la tecla Intro): 


. > * 

import java.awt. ;5 
import javax.swing.*; 
import java.awt.event.*; 


JE 

<APPLET 
CODE = botonpordefecto.class 
WIDTH= 300 
HEIGHT = 200 > 

</APPLET> 

*/ 


public class botonpordefecto extends JApplet ( 
JButton buttonl = new JButton ("Haga clic aquí"); 
JButton button2 = new JButton ("Haga clic aquí"); 
JTextField text = new JTextField(20); 


public void hit () 
{ 


Container contentpane = getContentPane (|); 


button. setEnemonioci HÌ p 
gátlcatPáss i j. setDefaultiutt on iat toāäll ,; 


peticotPane().roquestFocua i ii 


public void action-erformed(ActionEventevent) 


text .setText (" ¡Hola desde Swing!"); 
1); 


button2.add-ctionLi-tener (newActionListener() 


( 


public void actionPerformed(ActionEvent event) 
text .setText (" ¡Hola desde Swing!"); 


1); 


El resultado se muestra en la figura 12.7. Como se puede ver, el segundo 
botón aparece con un borde resaltado, indicando que es el botón por defecto, 
y la letra H de su etiqueta está subrayada, indicando que es el mnemónico del 
botón. Cuando el usuario pulsa la tecla Intro, se hace clic sobre el botón por 


defecto automáticamente, visualizando el mensaje que se muestra en la figura 
12.7. 


Figura 12.7. Usar un botón por defecto con un mnemónico. 


Usar botones toggle 


El programador novato regresa con una pregunta: "¿Añade Swing nuevos 
tipos de botones a Java?" "Bien", le dice, "sí y no". "Sabía que diría eso", 
dice PN. "Ahora están los botones toggle "le contesta, "pero son realmente la 
clase base de las casillas de activación y de los botones de opción". "iCuénte- 
me más! "dice PN. 

Los botones toggle son nuevos en Swing, y presentan un botón de dos 
estados (realmente tres estados si se cuenta el estado deshabilitado) que 


g7 


an 
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pueden aparecer como seleccionados o no. Este es el diagrama de 
JToggleButton, la clase de los botones toggle: 


Los constructores de esta clase se encuentran en la tabla 12.13 y sus” 


métodos en la 12.14. 


Tabla 12.13. Constructores de la clase JToggleButton. 


Constructor 


JToggieButtonj) 
JToggleBultoniconicono) 


JToggleButton(Iconicono, boolean 
selected) 


JToggleButton(String texto) 


JToggleButton(String texto, boolean 
selected) 


JToggleButton(String texto, /con 
icono, boolean selected) 


Descripción 


Construye un botón toggle. 


Construye un botón toggle no se- 
leccionado con la imagen indicada. 


Construye un botón toggle con la 
imagen y estado indicados. 


Construye un botón toggle no se- 
leccionado con el texto indicado. 


Construye un botón toggle con el 
texto y estado indicados. 


Construye un botón toggle con el 
texto, imagen y estado indicados. 


Tabla 12.14. Métodos de la clase JToggleButton. 


Método 


AccessibleContextgeiAccessible- 
Contexto 


String getUlClassIiD() 


protected String paramStringO 


void updateUl() 


Descripción 


Obtiene el contexto accesible. 


Obtiene una cadena que gestiona el 
nombre y la apariencia. 


Obtiene una representación en ca- 
dena de este botón toggle. 


Llamado por la clase UlFactory para 
indicarquela apariencia hacambiado. 


Usaremos JToggleButton en un ejemplo. En él, dibujamos algunos botones 
toggle, la mayoría con iconos y algunos con texto. Así es el código: 


import jJava.awt.*; 
import jJavax.swing.*; 
import java.awt.event.*; 


public class toggle extends JApplet 
{ 

public toggle0 

I 


Container contentpane = getContentPane0; 
Icon icon = new ImageIcon ("toggle.jpg"); 


JToggleButton togglel = new JToggleButton (icon); 
JToggleButton toggle2 = new JToggleButton (icon, true); 
JToggleButton toggle3 = new JToggleB-tton (~;Hagalic awí!"); 
JToggleButton togglel = new JToggleButton ("iHaga clic agui!", 
icon); 
JToggleButtontoggle5 = new JToggleButton ("“Hagaclic aquí!",icon, 


true) 5 
p tenp pane. netLayout [new FlowLafott ii 


contartPane.additoppleldi; 
contentPane. add] togglezi; 
content Pama. add toggle], 
costestFane.additoggledi; 
contentFane. addj|tóògglañj i 


El resultado de este código se puede ver en la figura 12.8. 


TOGELE 


TOGGLE] —= 
TOGGLE muaa 


Figura 12.8. Usar botones toggle. 


Como se puede observar en ella, se fija el estado de un botón toggle 
pasando a su constructor un valor Verdadero si se quiere que aparezca selec- 
cionado inicialmente. Este ejemplo está en el CD como toggle.java. 


Crear grupos de botones toggle 


El programador novato dice, "Los botones toggle son nuevos en Swing, 
¿hacen algo más que presentar al usuario un estado seleccionado o no selec- 
cionado?" "Claro", le responde, "se pueden agrupar". 


Los botones toggle se pueden agrupar como cualquier otra clase de boto- 
nes, con la clase ButtonGroup: 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


public class grupotoggle extends JApplet 
{ 
public grupotoggle () 
( 
Container contentpane = getContentPane0; 
ButtonGroup group = new ButtonGroupo; 


JToggleButton[] buttons = new JToggleButton![] ( 
new JToggleButton(new Imagelcon ("toggle.jpg")), 
new JToggleButton(new Imagelcon ("toggle.j3Jpg")), 
new JToggleButton (new Imagelcon ("toggle.j3Jpg")) 
new JToggleButton (new Imagelcon("toggle.j3Jpg")), 
new JToggleButton(new Imagelcon("toggle.jpg")) 


El resultado se muestra en la figura 12.9, Los botones toggle están actuan- 
do, de hecho, como un grupo; por lo tanto, cuando se hace clic sobre uno, de 


ellos cualquiera de los otros botones que estuviera seleccionado se deselecciona 
automáticamente. Este ejemplo está en el CD como grupotoggle.java. 


TOGGI-E 
TOGELE 


TOGGLE 
TOGG ana 


TOGGLE 


rr Led 


Figura 12.9. Usar botones toggle en un grupo. 


Usar casillas de activación 


El programador novato dice, "Necesito algo para que el usuario pueda 
seleccionar una opción. Necesito algo para que el usuario pueda seleccionar 
desde muchas opciones, de hecho. Necesito algo para que el usuario seleccio- 
ne múltiples opciones de muchas opciones. Necesito... "Casillas de activa- 
ción", le responde. "Lo que necesita son casillas de activación". "Cierto", 
dice PN. La clase JCheckBox tiene algunas ventajas sobre la clase AWT 
CheckBox, como visualizar imágenes. Este es el diagrama de herencia de la 
clase JCheckBox: 


java. ang- COJBOt 


Los constructores de esta clase se encuentran en la tabla 12.15 y sus 
métodos en la 12.16. 


Truco: En futuras versiones de Java, lás casillas aa rta 
rán texto Ls l i f 


Tabla 12.15. Constructores de la clase JCheckBox. 
Constructor Descripción 


JCheckBoxO Construye una casilla de activación. 


JcheckBox(Icon icono) Construye una casilla de activación 
con un icono. 


JCheckBox(1conicono, boolean Construye una casilla de activación 
seleccionado) conuniconoe indica siestá seleccio- 
nado inicialmente. 


JCheckBox(String texto) Construye una casilla de activación 
con texto. 


JCheckBox(String texto, boolean Construye una casilla de activación 
seleccionado) con texto e indica si está seleccio- 
nado inicialmente. 


JCheckBox(String texto, Icon icono) Construye una casilla de activación 
con el texto e iconos indicados. 


JCheckBox(String texto, lconicono, Construye una casilla de activación 
booleanseleccionado) con texto y un icono e indica si está 
seleccionado inicialmente. 


Tabla 12.16. Métodos de la clase JCheckBox. 


Método Descripción 


AccessibleContextgetAccessible- Obtiene el contexto accesible. 
Contexto 


String getUlClassID() Obtiene una cadena que indica el 
nombre de la clase de apariencia. 


protected String paramString() Obtiene una representación en ca- 
dena de esta casilla de activación. 


void updateUl() Llamadopor la clase Ulfactorypara 
indicarquelaaparienciahacambiado. 


Veamos un ejemplo. Aquí, se visualizan cuatro casillas de activación y se 
indica la que el usuario ha marcado (observe que, como en AWT, se usa 
ItemListener con los objetos JCheckBox, noActionlistener): 

import java.awt.*; 


import javax.swing.*; 
import java.awt.event.*; 


J 


public class casilladeactivacionextendsJApplet implements ltemListener 
I 

JCheckBox check1, check2, check3, check4; 

JTextField teXt; 


public void inito0 

( 
Container contentpane = getContentPane0; 
contentPane.setLayout (new FlowLayouto); 


checkl = new JCheckBox ("Casilla de activación 1 
check2 = new JCheckBox('Casilla de activación 2" 
check3 = new JCheckBox ("Casilla de activación 3"); 
check4 = new JCheckBox ("Casilla de activación 4"); 


check. «ddictealiotenerithie!y 
checka: adiItemLbistanar {this} r 
cheok3. adäItenLiatanar{this}r 
chsckd.adiitemlistenerithia)hy 


content Pane: addichscki)r 
oontent Fana., add|chacki} j 
content Pame. add ichsokd) y 
contentPane, adi[chacki)} ; 
text = new JTextField(20); 


content Pans. add [tast pj 


public void itemStateChanged (1temEvent e) 
{ 


if (e.getItemSelectable0 == checkl) { 

te-t.setText (~Seleccionóla casilla de activación 1."); 
j else if (e.getltemSelectable() == check2) t 

text . setText (' Seleccionó la casilla de activación 2."); 
j else if (e.getlIitemSelectable0 == check3) ( 

text.setText ("Seleccionó la casilla de activación 3."); 
j else if (e.getItemSelectable() == check0 ( 


text.setText ("Seleccionó la casilla de activación 4."); 
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El resultado se puede ver en la figura 12.10. Como se ve, la applet 
devuelve la casilla de activación que se ha seleccionado. Este ejemplo está en 
el CD como casilladeactivacion.java. Veremos más cosas sobre el uso de las 


casillas de activación en Swing, en los siguientes apartados, como es el 
siguiente de los botones de opción. 


îi Casilla de xthmiún 111? Casilade acttweión2' 


[Cmn de activación 3 PCasile de meia i 


Eateccioná la zasilla de activ; 11 nd 


Figura 12.10. Usar casillas de activación. 


Usar botones de opción 


"De acuerdo”, dice el programador novato, "necesito botones de opción en 
mi código Swing. ¿Se hace usando la clase JCheckBox?" "No", le contesta. 
"Aunque se puede usar la clase CheckBox para hacer botones de opción en 
la programación AWT, en Swing existe JRadioButton". "¡Qué bien!" dice 
PN. 

Este es el diagrama de herencia de la clase JRadioButton: 


java. lang. Object 
| jarra dt Component 
| ara awt Container 
| jarax. seing. ¿Component 
| — Javar. 5 text ĀAbetractButtan 
javax ating. JTogglefatton 
Javar.sw6ing-JRadiloButtón 


A diferencia de la programación AWT, los botones de opción tienen su 
propia clase en Swing, la clase JRadioButton. Los constructores de la clase 
JRadioButton se encuentran en la tabla 12.17 y sus métodos en la tabla 
12.18. 


Tabla 12.17. Constructores de la clase JRadioButton. 


Descripción 


Constructor 


JAadioBuitonii 
JRadioButton(1con icono) 


JRadioButton(1con icono, boolean 
seleccionado) 


JRadioButton(String texto) 
JRadioButton(String texto, boolean 


seleccionado) 
JRadioButton(Stringtexto,/conicono) 


JRadioButton(Stringtexto, /con icono, 
booleanseleccionado) 


Construye un botón de opción sin 
texto. 


Construye un botón de opción con la 
imagen indicada pero sin texto. 


Construye un botón de opción con la 
imagen y estado de selección indica- 
dos. 


Construye un botón de opción con el 
texto indicado. 


Construye un botón de opción con el 
texto y estado de selección indicado. 


Construye un botón de opción que 
tiene el texto y la imagen seleccio- 
nados. 


Construye un botón de opción que 
tiene el texto, imagen y estado de 
selección indicados. 


Tabla 12.18. Métodos de la clase JRadioButton. 


Método 


AccessibleContextgetAccessible- 
Contexto 


String getUlCalssID() 


protected String paramString() 


void updateUl() 


Descripción 


Obtiene el contexto accesible. 


Obtiene el nombre de la clase de 
apariencias. 


Obtiene una representación en 
cadena de este botón de opción. 


Llamado por la clase UlFactorypara 
indicar que la apariencia ha cam- 
biado. 


Veamos un ejemplo. Aquí sólo se visualizan cuatro botones de opción y se 
agrupan para que sólo se pueda seleccionar uno de ellos al mismo tiempo. 


Este es el código: 


import jJava.awt.*; 
import javax.swing.*; 


import java.awt.event.*; 


public class grupobotonesopcionextends JApplet implements ItemListener 


( 


JRadioButton radiol, radio2, radio3, radiol; 
ButtonGroup group; 
JTextField text; 


public void init () 

I 
Container contentpane = getContentPane0; 
contentPane.setlLayout (new FlowLayoutoO); 


group = new ButtonGroupo; 


radiol = new JRadioButton ("Botón de opción 1"); 
radio2 = new JRadio-utton (-Botónle opción 2"); 
radio3 = new JRadioB-tton (-Botóde opción 3"); 
radio4 = new JRadio-utton (-BotóÓde opción 4"); 


group- add (radio), 
group. add radiod); 
group. .add(radiod)p 
group aði radiot j 


radisl:adiItenListensr thin) 
radio. addlteabistenerithia)j; 
sádió3.addicastdatanas (tha) 
radiod.addlcamlistener (this)? 


contentFane. add lradioil: 
contaste Pañs.4dd[ radio) 
contcencFane. add [radioT!; 
comtscoerPane, add [(radiod):; 


text = new j-extFieid(20); 


intentan. add [tant 


public void itemStatechanged (1ltemEvent e) 
I 
if (e.getItemSelectable() == radiol) ( 
text.set-ext (-Seleccionéel botón de opción 1."); 
> else if (e.get-temSelectable() == radio2) ( 
text .set-ext (“-Seleccionél botón de opción 2."); 


) else if (e.getIltemSelectable() == radio3) ( 
text .setText ("Seleccionó el botón de opción 3."); 
) else if (e.getltemSelectable0 == radiol) ( 
text.setText ("Seleccionó el botón de opción 4."); 
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El resultado de este código se muestra en la figura 12.11. Todos los 
botones de opción de la figura actúan juntos, como parte de un grupo. Cuando 
se hace clic sobre uno, cualquiera que hubiera seleccionado se deselecciona. 
Este ejemplo está en el CD con el nombre grupobotonesopcion.java. 


larpin emr a e hara 


da ad ció ] ¡loíón da opción | 
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Figura 12.11. Usar botones de opción. 


Usar imágenes en casillas de activación 
y botones de opción 


"Uh-oh", dice el programador novato, "de nuevo Java está graciosillo. 
Añadí una imagen a una casilla de activación y ahora no funciona". Sonríe y 
le responde, "Eso es porque además hay que añadir una imagen seleccionada 
a la casilla de activación. De lo contrario, la apariencia de la casilla de 
activación no cambiará cuando se haga clic sobre ella". 

Ahora que ya sabe añadir casillas de activación y botones de opción, 
observemos un punto importante: si utiliza imágenes en casillas de activación 
o botones de opción, no hay indicación visual en el control (como la marca de 
activación) para mostrar si están seleccionados, por lo tanto se debe añadir al 
control una imagen seleccionada. 

Este es un ejemplo que muestra cómo funciona. Aquí, añadimos una 
imagen seleccionada a una casilla de activación: 


import java.awt.*; 
import javax.swing.*; 


import java.awt.event.*; 


public cla-sima-encasillaactivacionextendsJAppletimplementEemListener 


{ 
JCheckBox checkl; 
JTextField.text; 


public void init () 


{ 
Container contentpane = getContentPane0; 
contentPane.setLayout (new FlowLayouto ); 


checkl = new JCheckBox ("Casilla de activación 1", new 
ImageIcon ("normal.jpg")); 


ebsckl.sstslesctedicoo (nv InapgeIcon|"selscolonsdo. parir 


obsckl.addltenLlistener[this);¿ 


public void itemStateChanged(ltemEvent e) 


{ 
if (e.getItemSelectable() == checkl) ( 


text.setText ("Seleccionó la casilla de activación 1."); 
1 


El resultado se muestra en la figura 12.12. Cuando el usuario hace cliC 
sobre la casilla de activación, aparece la imagen seleccionada (selected), 


como se muestra en la figura. Este ejemplo está en el CD como imagencasilla- 
activacion. java. 


Obtener y fijar el estado de las casillas de 
activación y de los botones de opción 


Es bastante fácil responder a los eventos de las casillas de activación y de 
los botones de opción, pero a veces se quiere trabajar con estos controles 


fuera de los métodos de gestión de eventos. Por ejemplo, el usuario puede 
seleccionar un número de opciones usando casillas de activación en un cua- 
dro de diálogo que no tienen efecto hasta que se salga del cuadro de diálogo. 
En ese momento, es necesario determinar qué casillas de activación están 


seleccionadas. 


Figura 12.12. Usar imágenes en casillas de activación. 
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Para determinar si una casilla de activación o botón de opción está selec- 
cionado se puede usar el método is Selected y el método setState para fijar el 
estado de una casilla de activación o radio de opción. Este es un ejemplo en el 
que visualizamos cuatro casillas de activación y listamos las que están mar- 
cadas cuando el usuario hace clic sobre ellas. 

Empecemos creando un array de cuatro casillas de activación y 


visualizarlos: 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


public class casilladeactivacionseleccionada extends JApplet irnplements 


ItemListener 


I 


JCheckBox checks[1; 


“sextFieltext; 


public void init O 

I 
Container contentpane = getContentPane0; 
contentPane.setLayout (new FlowLayoutoO); 


checks = new JCheckBox[1I; 


for(int loop—-index = 0; loop—index <= checks.length ” 1; 
loop—idex++) ( 


checks [loop-index] = new “CheckBox ("Casillade activación " 
+ loop—index); 
checks [loop-index] .add-te-istener (this); 
content-ane.add (checks [l1loop-indexl); 


text = new JTextFieldílO0); 


Ahora, cuando el usuario hace clic sobre una casilla de activación, reco- 
rremos un bucle con todas las casillas de activación, usando el método 
isSelected para ver si están seleccionadas y listar aquellas que lo están: 


public void itemStateChanged (1temEvent e) 


t 
String outstring = new String("Actualmenteseleccionada: "); 


for (int loop—index = 0; loop—index <= checks.length - 1; 
loop-index++) { 
if(checks[loop-index].isselected()) I 
outstring += " casilla de activación 


+ loop—index; 
1 

1 

text.setText (outString); 


El resultado se muestra en la figura 12.13. Como se puede ver, cuando el 
usuario selecciona las casillas de activación, la applet indica las que están 
seleccionadas. 


Este ejemplo está en el CD con el nombre casilladeactivacionselecciona- 
da.java. 


“tualmente seleccionada casilla de act n 2 casilla deactivac-ór8 


Figura 12.13. Determinar si las casillas de activación están seleccionadas. 


m Swing: 
viewports, 
desplazamiento, 
deslizadores 

y listas 


En este capítulo trataremos algunos temas importantes de la Swing: 
Viewport, paneles de desplazamiento, deslizadores, barras de desplazamien- 
to y cuadros de lista. Los controles de este capítulo tienen todos una cosa en 
común: el desplazamiento. El de lista, en concreto, es un control muy impor- 
tante en la Swing, pero no procesa el desplazamiento por sí mismo, por lo que 
necesitamos comprender cómo funciona con desplazamiento antes de trabajar 
con vistas y muchos otros controles de la Swing. Hagamos una breve descrip- 
ción de los temas de este capítulo antes de profundizar en el código. 


Viewports 


La clase JViewport es el corazón del desplazamiento en la Swing. Un 
viewport es una ventana dentro de una vista, que visualizará una sección de 
nuestros datos. Podremos desplazar manualmente los Viewports. Utilizando 
Viewports, podemos desplazarnos por los datos visualizados, de forma simi- 
lar a aquella en que realizamos nosotros mismos el desplazamiento. Exami- 
naremos el uso de la clase JViewport para desplazar imágenes. 
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Paneles de desplazamiento 


Una forma común de implementar el desplazamiento en la Swing es utili- 
zar paneles de desplazamiento, puesto que permiten desplazar componentes. 
Varios controles de la Swing, como el control JList, implementan la interfaz 
Scrollable para trabajar con paneles de desplazamiento. De hecho, éstos se 
utilizan habitualmente con controles JList para crear listas desplazables. 


Deslizadores 


Otro control desplazable es el control deslizador de la Swing, soportado 
por la clase JSlider. Los deslizadores son similares a los controles que vemos 
en los dispositivos de audio que permiten deslizar un mando a lo largo de una 
pista. De hecho, los deslizadores son como barras de desplazamiento, excep- 
to porque explícitamente utilizamos deslizadores para permitir al usuario 
seleccionar un valor dentro de un rango continuo. 

Puede hacer lo mismo, por supuesto, con barras de desplazamiento, pero 
los deslizadores se introducen aquí debido a que los usuarios actualmente 
esperan que las barras de desplazamiento se utilicen para desplazar otros con- 
troles, como las áreas de texto. 


Barras de desplazamiento 


Listas 


Cada usuario de una Ul conoce las barras de desplazamiento, por supues- 
to, y la Swing las soporta al igual que hacía el AWT. Utilizaremos la clase 
JScrollBar en este capítulo desplazando texto en un applet. Cuando el cuadro 
de desplazamiento (también llamado burbuja o marcador)se mueva, el valor 
de la barra de desplazamiento cambiará. Puede hacer clic sobre los botones de 
flecha en los extremos de la barra de desplazamiento para cambiar el valor de 
la barra de desplazamiento en el incremento de bloque, y también puede 
hacer clic sobre la pista de la barra de desplazamiento para cambiar su valor 
en su incremento unitario. 


Las listas, soportadas por la clase JList en la Swing, son unos controles 
muy populares, debido a que permiten presentar una lista de elementos senci- 


lla de manejar, ocultando una larga lista de elementos al hacer que el cuadro 
de lista sea desplazable. Mostraremos cómo desplazar largas listas y veremos 
diversos temas de la Swing. Por ejemplo, puede realizar selecciones múlti- 
ples de diversas formas en los cuadros de lista de la Swing. También puede 
visualizar imágenes, manejar eventos de clics de ratón dobles y triples e 
incluso aún más. Verá cómo funciona todo esto en este capítulo. También 
examinaremos cómo implementar un nuevo modelo para listas, asícomo para 
renderizadores de celdas, con el fin de manejar la visualización real de cada 
elemento en la lista de una forma personalizada. 

Hasta aquí el resumen de este capítulo. Como puede ver, vendrá mucho 
más. Es el momento de pasar al primer punto. 


Manejo de viewports 


"Mmh", dice el programador novato, "quiero mover una imagen bajo 
control de programa, sin mostrar ninguna barra de desplazamiento al usuario. 
¿Existe alguna forma de hacerlo?". "Como es natural", contestamos, "existe; 
puede utilizar un viewport". 

Los viewports representan ventanas o portales en una vista. Imagine, por 
ejemplo, que tiene un documento enorme, que no se puede visualizar en la 
pantalla en un momento dado. Para presentar al usuario una única parte del 
documento, puede configurar un viewport en ese documento y mover el 
viewport a través del documento a medida que lo ve. De hecho, puede tener 
múltiples viewports para permitir que el usuario recorra los datos del modelo 
de su programa a voluntad. Los viewports están soportados por la clase 
JViewPort, que es la base del desplazamiento en la Swing. Aquí tenemos el 
diagrama de herencia para esta clase: 


java.lang.Object 
-java.awt . Component 

3 ava.awt.Container 
-javax.swing.JComponent 
-javax.swing.JViewPort 


Encontrará los campos para la clase JViewPort en la tabla 13.1, su cons- 
tructor en la tabla 13.2 y sus métodos en la tabla 13.3. 


Tabla 13.1. Campos de la clase JViewPort. 


Campos Descripción 


protected boolean backingstore Devuelve true cuando el viewport 
mantiene una imagen fuera de pan- 
talla de sus contenidos. 
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Campos Descripción 


protected Image backingstorelmage La imagen utilizada para un fondo. 


protected boolean isViewSizeSet 


protected Point lastPaintPosition 


| protected boolean scrollunderway 


Devuelvetrue cuando se han asigna- 
do las dimensiones del viewport. 


La última viewPosition pintada. 


El indicador scrollUnderway indica 
siuna operación de desplazamiento 
está en marcha. 


Tabla 13.2. El constructor de la clase JViewPort. 


Constructor Descripción 


JViewport() 


Construye un objeto JViewport. 


Tabla 13.3. Métodos de la clase JViewPort. 


Método 


void addChangeListener(ChangeLis- 
tener 1) 


protected void addlmpl(Component 
child, Object constraints, int index) 


protected boolean computeBlit(int dx, 


int dy, Point blitfrom, Point blitTo, Di- 


mension blitsize, Rectangle blitPaint) 


protected LayoutManager create- 
LayoutManagerO 


protected JViewport.ViewListener 


| createViewListener() 


protected JViewport.ViewListener 
createViewListener() 


protected void fireStateChangedO 


AccessibleContext getAccessible- 
Contexto 


Dimension getExtentSize() 


Descripción 


Añade un ChangeListener 


Asigna el hijo ligero del viewport, 
que puede ser nulo. 


Calcula los parámetros de unaope- 
ración Blit. 


Sobrescribe this para instalar un 
distinto gestor de distribución (o nu- 
lo) en el constructor. 


Construye un receptor para la vista. 


Notifica alos receptores de un cam- 
bio en una propiedad. 


Notifica a los receptores de un 
cambio de estado. 


Devuelve el contexto accesible. 


Devuelve el tamaño de la parte visi- 
ble de la pista. 


Método 


Deseripeión 


Insets getinsetso 


Insets getinsets(Insets insets) 


Component getView() 


Point getViewPosition() 


Rectangle getViewRect() 


Dimension getViewSize() 


boolean isBackingStoreEnabled() 


boolean isOptimizedDrawingEna- 
bledo 


void paint(Graphics g) 
protected String paramString() 


void remove(Componentchild) 


void removeChangeListener(Change- 


Listener 1) 


void repaint(longtm, intx, int y, int w, 


int h) 
void reshape(int x, int y, int w, int h) 


void scrollRectToVisible(Rectangle 
contentRect) 


Obtiene las dimensiones del Inset 
(borde) como (0,0,0,0). El objeto 
JViewport no soporta bordes. 


Devuelve un objeto Insets conte- 
niendo los valores del Insets del ob- 
jeto JViewport. 


Devuelve el hijo del viewporto nulo. 


Devuelvelascoordenadas de la vista 
que aparece en la esquina superior 
izquierda del viewport (00 si no 
existe vista). 


Devuelve un rectángulo cuyo origen 
es getViewPosition() y su tamaño 
es getExtentSizeo. 


Devuelve el tamaño preferido si se 
ha asignado tamaño; en cualquier 
otrocaso, devuelve eltamaño actual 
de la vista. 


Devuelve true si el viewport man- 
tiene una imagen fuera de pantalla. 


JViewport sobrescribe éste método 
para devolver falso. 


Pinta la imagen. 


Devuelve una representación de 
cadena de este objeto JViewport. 


Elimina el componente hijo ligero 
del viewport. 


Elimina un receptor de cambios de 
la lista. 


Pinta de nuevo la lista. 


Asigna los límites de este viewport. 


Sobrescrito para desplazar la vista 
de tal forma que el rectángulo que 
contiene la vista pase a ser visible. 


Método 


void setBackingStoreEnabled(boo- 
lean x) 


void setBorder(Border border) 
void setExtentSize(Dimension new- 
Extent) 


void setView(Component view) 


void setViewPosition(Point p) 


void setViewSize(Dimension new- 
Size) 


Dimension toViewCoordinates 
(Dimension size) 


Point toViewCoordinates(Point p) 


Descripción 


Si el valor x es true, el viewport 
mantendrá unaimagenfuerade pan- 
talla. 


Asigna un borde. 


Asigna el tamaño de la parte visible 
de lavistautilizandolas coordenadas 
de vista. 


Asigna el hijo ligero del viewport(su 
vista). 


Asigna las coordenadas de vista 
que aparecen en la esquinasuperior 
izquierda del viewport. 


Asigna las coordenadas de vista 
que aparecen en la esquina superior 
izquierda del viewport así como el 
tamaño de la vista. 


Convierte un tamaño en coordena- 
das de puntos a coordenadas de 
vista. 


Convierte un punto en coordenadas 


de puntos a coordenadas de vista. 


Vamos a examinar un ejemplo de Viewport que permite al usuario despla- 
zar el viewport con botones y no con barras de desplazamiento. Aquí, añadi- 
mos un viewport con la imagen a un programa, asícomo un panel conteniendo 
botones con los textos desplazar izquierda, desplazar arriba, desplazar abajo 
y desplazar derecha. El usuario puede desplazar la imagen en el viewport 
haciendo clic con el ratón sobre los botones. 

Comencemos creando un nuevo viewport y después, un nuevo panel. 
Añadiremos unaetiqueta con una imagen al panel y después añadiremos éste 
al viewport. Cuando el usuario desplace el viewport, estará desplazando 
realmente el panel. Aquí tenemos el mecanismo para crear el viewport Y 
añadirlo al programa (observe que para añadir realmente el panel al viewport, 
utilizamos el método setView de la clase JViewPort, que asigna el objeto 
vista del viewport): 


import java.awt. Ss 
import javax.swing.*; 


import jJava.awt.event.*; 


UA 


public class viewport extends JApplet 


{ 


public viewport () 


I 


container contentpane = getContentPane0; 


JViewport jviewport = new JViewporto; 


JPanel jpanel 


= new JPaneloO; 


jpanel .añdimnew JLabel (ner Imageroocn | "viewport.Jpg"1115 


jviewporet .satViaw{jpanelji 


contentPane. add (ivismport, BorderLayovut. CENTER) ; 


También necesitamos otro panel que no forme parte del viewport, en el 
que visualizaremos los botones que puede utilizar para el desplazamiento. 
Llamaremos a éste panel buttonpanel. Observe ahora que pasamos el viewport 
al constructor de esta clase para poder desplazar el viewport. Aquítenemos la 
forma de almacenar el viewport pasado al constructor y añadimos los botones 
necesarios para el desplazamiento: 


class buttonpanel extends JPanel implements ActionListener 


I 


JViewport jviewport; 


JButton buttonl new JButton ("Desplazara la izquierda"); 
JButton button2 new JButton ("Desplazararriba"); 
JButton button3 new JButton ("Desplazar abajo"); 

JButton button4 new JButtoníMDesplazara la derecha") ; 


public buttonpanel (JViewport vport) 


add (buttonl); 

add (button2); 
add (button3); 
add (button4); 


Todo lo que tenemos que hacer es implementar el desplazamiento cuando 
el usuario haga clic sobre un botón. Para hacerlo, utilizamos el método 
getViewPosition de la clase JViewPort para obtener la posición actual de la 
vista. Después, cambiamos esa posición (de acuerdo con el botón sobre el 
que se haya hecho clic) en 10 puntos y utilizamos el método setViewPosition 
para asignar la nueva posición del viewport: 


public void actionPerformed(ActionEvent e) 


I 


Point position = jviewport .getViewPosition0; 


if(e.getSource() == buttonl) pO0sition.x += 10; 

else if(e.getsource() a= button2) pO0sition.y += 10; 
else if(e.getSource() == button3) pOsition.y -= 10; 
else if(e.getSource() == buttonl) pOsition.x -= 10; 


jriewport .ntYisPosition(ponitioa)ls 


Ahora instalamos un objeto buttonpanel al pie del applet, como sigue: 


public class viewport extends JApplet 
I 
public viewporto 
I 
Container contentpane = getContentPane0; 


JViewport jJviewport = new JViewporto; 
JPanel jpanel = new JPanelO; 


jpanel .add (new JLabel(new Imagelcon ("viewport .jpg"))) ; 


tar” . J j inp . r Y A Y ESTE j 
tent Pane. a imu i darla out. CEXTEF 


contantFana. add (se betrosparel (iviswmport), Borderiafont . SOTH) $ 


El resultado se muestra en la figura 13.1. Como vemos, los botones de 
desplazamiento aparecen al pie del applet. Cuando el usuario hace clic sobre 
un botón, la imagen se mueve de forma correspondiente. Este applet es un 


éxito y se encuentra en el archivo viewport.java del CD que acompaña a este 
libro. 


Normalmente, no utilizaremos siempre la clase JViewPort para manejar 
nuestro desplazamiento; en su lugar, utilizaremos componentes como paneles 
de desplazamiento, que examinaremos a continuación. 


VIEWPORT] 


Depiaras a innia i a arts | i | Dar dd 


pre mirad 


Figura 13.1. Desplazamiento de un viewport. 


Creación de paneles de desplazamiento 


El programador novato aparece y dice: "Oye, Java ha fallado de nuevo. He 
creado un nuevo control de lista de la Swing, insertado 40.000 elementos en 
el mismo y aparecen únicamente dos visibles a la vez y no existen barras de 
desplazamiento. Esto es un error, voy a crear un informe y...". "Espera", le 
decimos. "El control JList no implementa desplazamiento por sí mismo, pero 
lo puedes poner en un panel de desplazamiento". El PN pregunta, "¿De 
verdad? ¿Es ésa la forma en que se espera que funcione?". 

La clase JScrollPane es la implementación ligera en la Swing de un panel 
de desplazamiento y podemos utilizarlo para desplazar otros controles. De 
hecho, siempre que visualicemos una lista, el mecanismo habitual es 
visualizarla dentro de un panel de desplazamiento para permitir al usuario 
desplazar los elementos de la lista. 

Gracias a la nueva interfaz Scrollable de la Swing, las operaciones de 
desplazamiento se coordinan de una forma mucho más próxima al control 
que se desplaza (las clases JViewPort, JScrollPane y JScrollBar implementan 
todas esta interfaz). Aquí tenemos el diagrama de herencia para JScroll- 
Pane: 


Encontrará los campos para la clase JScrollPane en la tabla 13.4, sus 
constructores en la tabla 13.5 y sus métodos en la tabla 13.6. 


Tabla 13.4. Campos de la clase JScrollPane. 


Campos Descripción 


protected JViewport columnHeader 


Bar 


protected Component lowerLeft 
protected Component lowerRight 


protected JViewport rowHeader 
protected Component upperLeft 


protected Component upperRight 


protected int verticalScrollBarPolicy 


protected JViewport viewport 


protected JScrollBar horizontalScroll- 


protected int horizontalScrollBarPolicy 


protected JScrollBar verticalScrollBar 


El hijo cabecera de columna. 


El hijo barra de desplazamiento hori- 
zontaldelpanelde desplazamiento. 


La política de visualización para la 
barra de desplazamiento horizontal. 


El componente a visualizar en la es- 
quina inferior izquierda. 


El componente a visualizar en la es- 
quina inferior derecha. 


Elcomponente hijo cabecera defila. 


El componente a visualizar enla es- 
quina superior izquierda. 


El componente a visualizar en la es- 
quina superior derecha. 


El hijobarrade desplazamientoverti- 
cal del panel de desplazamiento. 


La política de visualización para la 
barra de desplazamiento vertical. 


El hijo panel de desplazamiento del 
viewport. 


Tabla 13.5. Constructores de la clase JScrollPane. 


Constructor Descripción 


JScroll Panel) 


JScrollPane(Component view) 


JScrollPane(Componentview, int 
vsbPolicy, int hsbPolicy) 


Construye un objeto JScrollPane 
vacío. 


Construye un objeto JScrollPane 
que visualice los contenidos del com- 
ponente indicado. 


Construye un objeto JScrollPane 
que visualice el componente vista 
en un viewport cuya posición de 


Constructor Descripción 


JScrollPane(int vsbPolicy, int hsb- 
Policy) 


vista se pueda controlar con un par 
de barras de desplazamiento. 


Construye un objeto JScrollPaneva- 
cíoconpolíticasde barras de despla- 
zamiento indicadas. 


Tabla 13.6. Métodos de la clase JScrollPane 


Método Descripción 


JScrollBar createHorizontalScrollBar() Crea la barra de desplazamiento 


JScrollBar createVerticalScrollBar() 


protected JViewport createViewport() 


AccessibleContext getAccessible- 
Contexto 


JViewport getColumnHeader() 
Component getCorner(String key) 


JScrollBar getHorizontalScrollBar() 
int getHorizontalScrollBarPolicy() 


JViewport getRowHeader() 
ScrollPaneUl getUl() 


String getUlClassID() 


JScrollBar getVerticalScrollBar() 


int getVerticalScrollBarPolicy() 


horizontal. 


Crea la barra de desplazamiento 
vertical. 


Obtiene un nuevo objeto JScroll- 
Pane predeterminado. 


Obtiene el contexto accesible aso- 
ciado con este objeto JComponent. 


Obtiene la cabecera de columna. 


Obtiene el componenteenlaesquina 
indicada. 


Obtiene la barra de desplazamiento 
horizontal. 


Obtiene el valor de la política de 
barras desplazamiento horizontal. 


Obtiene la cabeza de fila. 


Obtiene el objeto apariencia que 
renderiza éste componente. 


Obtiene la clave utilizada para bus- 
car la clase ScrollPaneUl que pro- 
porciona la apariencia para JScroll- 
Pane. 


Obtiene la barra de desplazamiento 
vertical. 


Obtiene el valor de la política para 
las barras desplazamiento vertica- 
les. 


a | 


Método 


JViewport getViewport() 
Border getViewportBorder() 


Rectangle getViewportBorderBounds() 


boolean ¡sopaque() 


boolean isValidateRoot() 


protected String paramString() 


void setColumnHeader(JViewport 
columnHeader) 


void setColumnHeaderView(Compo- 
nent view) 


void setCorner(String key, Compo- 
nent corner) 


void setHorizontalScrollBar(JScrollBar 


horizontalScrollBar) 


void setHorizontalScrollBarPolicy 
(int policy) 


void setLayout(LayoutManagerlayout) 


void setRowHeader(JViewportrow- 
Header) 


void setRowHeaderView(Component 


view) 


Descripción 


Obtiene el objeto JViewPort actual. 


Obtiene el valor de la propiedad 
viewportBorder. 


Obtiene los límites del borde del 
vie wport. 


Devuelve true si este componente 
pinta todos los puntos en su rango. 


Comprueba la raíz. 


Obtiene una representación de ca- 
dena de este objeto JScrollPane. 


Construye un viewport de cabecera 
de columna, y si es necesario, asig- 
na su vista y después añade el view- 
portde cabecerade columnaal panel 
de desplazamiento. 


Si existe una cabecera de columna 
vieja, este método la elimina. 


Añade un hijo que aparecerá en una 
de las esquinas de los paneles des- 
plazamiento (si existe espacio). 


Añade la barra de desplazamiento 
que controla la posición de la barra 
de vista horizontal del viewport al 
panel de desplazamiento. 


Determinacuándo aparece la barra 
de desplazamiento horizontal en el 
panel de desplazamiento. 


Asignael gestor de distribuciónpara 
este objeto JScrollPane. 


Asigna la nueva cabecera de fila. 


Construye un viewport para cabe- 

cera de fila, si es necesario, y des- 
pués añade el viewportparacabece- 
rade fila al panel de desplazamiento. 


Método Descripción 


void setUl(ScrollPaneUl ui) Asigna el objeto que proporciona la 
apariencia. 


void setVerticalScrollBar(JScrollBar Añade la barra de desplazamiento 
verticalScrollBar) que controla la posición de vista 
vertical del viewport. 


void setVerticalScrollBarPolicy(int Determina cuándo aparece la barra 
policy) de desplazamientovertical en el pa- 
nel de desplazamiento. 


void setViewport(JViewport viewport) Fuerzalaposicióndevistadelnuevo 
viewportala posición del cuadrante 


+X, +Y. 

void setViewportBorder(Border view- Añade un borde alrededor del view- 
portBorder) port. 

void setViewportView(Component Construye un viewporty, si es nece- 
view) sario, asigna su vista. 

void updateUl() Se llama cuando cambia la aparien- 


cia predeterminada. 


Vamos a examinar un ejemplo en el que añadiremos una distribución de 
rejilla alos campos de texto de un panel y desplazaremos el panel en un panel 
de desplazamiento. Comenzaremos creando un objeto JPanel relleno con 
campos de texto: 


import Java.awt.*; 
import javax.swing.*; 


public class scrollpane extends JApplet 
( 


public void initoO0 


( 


Container contentpane = getContentPane0; 


manel jpanel = new JPaneloO; 
jpanel . setLayout (new GridLayout (11, 16)): 


for (int outer = 0; outer <= 10; outer++) Í 


for (int inner = 0; inner <= 15; inner++) ( 
jpanel.add (new JTextFieldínCuadro de texto " + outer + 


vv A 
»" + inner)); 


Ahora, añadiremos este nuevo panel a un panel de desplazamiento. Cuan- 
do creemos un objeto panel de desplazamiento, pasaremos el objeto a despla- 
zar y podemos especificar cuándo y dónde deseamos las barras de 
desplazamiento con estas constantes: HORIZONTAL-SCROLLBAR- 
ALWAYS, HORIZONTAL-SCROLLBAR-AS-NEEDED, HORIZONTAL- 
SCROLLBAR- NEVER, VERTICAL-SCROLLBAR, VERTICAL- 
SCROLLBAR- ALWAYS, VERTICAL-SCROLLBAR-AS- NEEDED, 
VERTICAL-SCROLLBAR-NEVER. 


En este caso, siempre permitiremos que el panel de desplazamiento mues- 
tre las barras de desplazamiento: 


import java.awt.*; 
import jJavax.swing.*; 


public class scrollpane extends JApplet 
I 

public void init () 

( 


Container contentpane = getContentPane0; 


JPanel jpanel = new JPanelO; 
jpanel .setLayout (newGridLayout (11, 16)); 


foríint outer = O; outer <= 10; outer++) { 
for(int inner = O; inner <= 15; inner++) ( 
jpanel.add (new JTextField ("Cuadr0de texto " + outer + 
", * + inner)); 


1 


JScrollPane jscrollpane = new --croll-ane(jpanel, 
ScrollPaneConstants.VERTICAL-SCROLLBAR-ALWAYS, 
S === Por om ss . HORIZONTAL-SCROLLBAR- 


contastrane. add leorolilpanei 


El resultado de la adición de un panel de desplazamiento al panel de 
contenidos del applet se muestra en la figura 13.2. Como muestra la figura, el 
conjunto completo de la rejilla de campos de texto aparece en el panel de 
desplazamiento y el usuario puede desplazar esa rejilla con las barras de 
desplazamiento. Este ejemplo se encuentra en el archivo scrollpane.java del 
CD. 


usd de tato O, 0 vases de dado 01 [Cuadro de bento 0, 2 
Cuida de in l i ua 06 HEN 1,7 Cuadro de Sodio Y, 4 
Cuadro de mo J 0 ao de ra 1 
Cusi ie Eri l Fathi de Pel 

ido de lod, 9 Cudio de bado i cm de Pe dl, 

uada salado 5, 1 E wadn de kio 5 Cu wiry de eei d 

yaa h do E (d de ado i Cuadri de ih E, T 

padro de lada ?, D [Cuadro de iain T Cuasra de odo 7,3 


q cgeledo LD (Guado de iedod i cuadra da dad EJ 


Aopie siana] 


Figura 13.2. Uso de un panel de desplazamiento. 


Creación de paneles de desplazamiento con 
cabeceras y bordes 


El zar de la corrección programática aparece y dice: "-Javno tiene pane- 
les de desplazamiento? Bueno, no tienen una apariencia muy profesional; con 
controles profesionales, se pueden especificar etiquetas o incluso imágenes 
para utilizar como cabeceras de filas y columnas". "Sin problema", contesta- 
mos. "Se puede hacer en Java e incluso se puede seleccionar el tipo de borde 
también". "Vaya", dice el ZCP. 

Podemos personalizar un panel de desplazamiento añadiendo imágenes de 
cabecera o texto con los métodos setColumnHeaderView y setRowHeader- 
View. 

También podemos personalizar el borde utilizado en un panel de desplaza- 
miento con el método setViewPortBorder. 


Como ejemplo, crearemos esta personalización para que trabaje con el 
ejemplo de panel de desplazamiento que desarrollamos en el tema anterior. 
En este caso, utilizaremos etiquetas como cabeceras de filas y columnas y 


añadiremos un borde simple: 


import java.awt.*; 
import javax.swing.*; 


ZAPLET 
CODE =acre]lpane. clase 
WIDTH=2400 
HEIGNTZOO > 

<i APELETA 


public class scrollpane extends JApplet 
{ 
public void init () 


I 
Container contentpane = getContentPane0; 


JPanel jpanel = new JPanel(); 
jpanel.setLayout (new GridLayout (11, 16)); 


for (int outer = 0; outer <= 10; outer++) { 
foríint inner = 0; inner <= 15; inner++) { 
jpanel.add (new JTextField ("Cuadro de texto " + outer + 
*, ~ + inner)); 


1 


JScrollPane jscrollpane = new JScroll-ane (jpanel, 
ScrollPaneConstants.VERTICAL-=SCROLLBAR-AILWAYS, 
ScrollPaneConstants.HORIZONTAL-SCROLLBAR-ALWAYS) ; 


JLabel jlabell = new JLabel ("Etiqueta horizontal"); 
JLabel jlabel2 = new JLabel ("Etiqueta vertical"); 


jisorollpans.sstColersianderilaw(ilaballb; 
jesrolipane.cocihowHaadorvioe(ilabelz)p 
jacrollpane.sstviewportBorder (BorderFactory.crastsEbchediorderiii 


content Páne,addidecroligánal; 


La figura 13.3 muestra el resultado de éste código. 
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Figura 13.3. Adición de cabeceras a un panel de desplazamiento. 


Desplazamiento de imágenes 


Los paneles de desplazamiento proporcionan un mecanismo ideal para 
desplazar imágenes; todo lo que tenemos que hacer es mostrar la imagen en 
una etiqueta (o en un componente similar) y añadir esa etiqueta al panel de 
desplazamiento. Aquí tenemos un ejemplo que muestra cómo funciona: 


import java.awt.*; 
import jJavax.swing.*; 


11panelmaige.cian 


public class scrollpaneimage extends JApplet 


{ 


public scrollpaneimage0 


{ 


Container contentpane = getContentPane0; 


JLabel jlabel = new JLabel (new “-mage-con(“scrollpane.j-""))- 


JScrollPane jscrollpane = new JScrollPane (jlabel); 


contentPanes addi ]øcrollpana} F 


El resultado se muestra en la figura 13.4. Ahora el usuario puede desplazar 
una imagen tan grande como desee, para manipular imágenes que no puedan 


visualizarse al mismo tiempo. Este ejemplo está en el archivo scrollpaneima- 
ge.java en el CD. 


Figura 13.4. Desplazamiento de una imagen. 


Creación de deslizadores 


El programador novato vuelve y dice, "He visto un nuevo control en 
varios programas; deslizadores. ¿Cuándo piensas que lo tendremos en Java?". 
Sonríe y le dice, "Dentro de mucho tiempo". 

Podemos utilizar barras de desplazamiento para permitir al usuario selec- 
cionar un valor dentro de un rango continuo, pero los usuarios están más 
familiarizados con las barras de desplazamiento para otros controles, como 
las listas. 

Por esa razón, Swing añade la clase JSlider para dar soporte alos controles 
deslizamiento. 

Los deslizadores presentan controles al usuario similares a aquellos que 
vemos en un equipo de audio; están dirigidos claramente a permitir al usuario 
seleccionar un valor dentro de un rango. Para utilizar los deslizadores, el 
usuario desplaza un selector con el ratón. Aquí tenemos el diagrama de 
herencia para la clase JSlider: 


java.lang.Object 

-j ava.awt. Component 
—-java.awt.Container 
javax.swing.JComponent 


javax.swing.JSlider 


Puede encontrar los campos de la clase JSlider en la tabla 13.7, sus 
constructores en la tabla 13.8 y sus métodos en la tabla 13.9. 


Tabla 13.7. Campos de la clase JSlider. 


protected ChangeEvent changeEvent 


protected ChangeListener changelis- 
tener 


protected int majorTickSpacing 
protected int minorTickSpacing 
protected int orientation 


protected BoundedRangeModel 
sliderModel 


protected boolean snapToTicks 


Descripción 


El evento de cambio. 


El receptor de cambio. 


El número de valores entre las mar- 
cas de incremento mayores. 


El número de valores entre las mar- 
cas de incremento menores. 


La orientación del deslizador. 


El modelo de datos, que maneja el 
valor numérico máximo, valor míni- 
mo y valor para la posición actual 
del deslizador. 


Si vale true, la caja se resuelve a la 
marca siguiente más cercana adon- 


de el usuario ha situado el cuadro. | 


Tabla 13.8. Constructores de la clase JSlider. 


Constructor 


Descripción 


JSliden) 


JSlider(BoundedRangeModel brm) 


JSlider(int orientation) 


JSlider(int min, int max) 


JSlider(int min, int max, int value) 


Construye un deslizador horizontal 
con el rango Oa 100 y un valor inicial 
de 50. 


Construye un deslizador horizontal 
utilizando el modelo de límites de 
rango indicado. 


Construye un deslizador utilizando 
la orientación indicada con el rango 
O a 100 y un valor inicial de 50. 


Construye un deslizador horizontal 
utilizando los valores mínimo y 
máximo indicados con un valorinicial 
de 50. 


Construye un deslizador horizontal 
utilizando los valores mínimo, 
máximo e inicial indicados. 


631 


Constructor 


JSlider(int orientation, int min, int 


max, int value) 


Descripción 


Construye un deslizadorconla orien- 
tación indicaday los valores máximo, 
mínimo e inicial indicados. 


Tabla 13.9. Métodos de la clase JSlider. 


Metodo 


void addChangeListener(ChangeLis- 
tener ) 


protected ChangeListener create 
ChangeListenerO 


Hashtable createStandardLabels(int 
increment) 


Hashtable createStandardLabels(int 
increment, int start) 


protected void fireStateChangedO 


AccessibleContext getAccessible- 
Contexto 


int getExtent() 


boolean getinvertedo 


Dictionary getLabelTable0 
int getMajorTickSpacing() 
int getMaximum() 


int getMinimum() 


Descripción 


Añade un receptor de cambio al 
deslizador. 


Sobrescribe este método para de- 


volver su propia implementación del | 


receptor de cambios. 


Construye una tablahashque dibu- 
jará etiquetas de texto comenzando 
en el mínimo del deslizador. 


Construye una tablahash que dibu- 
jará etiquetas de texto comenzando 
en el punto indicado. 


Envía un evento de cambio a cada 
receptor, cuyo origen es el desli- 
zador. 


Obtiene el contexto accesible. 


Obtiene la extensión, quese encuen- 
tra en el rango de valores cubierto 
por el cuadro. 


Devuelvetrue, si el rango devalores 
mostrado para el deslizador está 
invertido. 


Obtiene el diccionario para dibujar 
las etiquetas. 


Obtieneel espaciamientode marcas 
mayores. 


Obtiene el valor máximo soportado 
por el deslizador. 


Obtiene el valor mínimo soportado 
por el deslizador. 


Método x Desc ripció ñ 


int getMinorTickSpacing() Obtiene el espaciamientode marcas 
menores. 


BoundedRangeModelgetModel() Obtiene el modelo de datos que 
maneja las tres propiedades funda- 
mentales de los deslizadores: míni- 
mo, máximo y valor. 


int getOrientation() Devuelve la orientación vertical u 
horizontal del deslizador. 

boolean getPaintLabels() Indica si se tienen que pintar las 
etiquetas. 

boolean getPaintTicks() Indica si deben pintarse las marcas. 

boolean getPaintTrack0 Indica si se debe pintar la pista. 

boolean getSnapToTicks() Devuelve true si el cuadro se resuel- 


ve ala siguiente marca más cercana 
a donde el usuario hubiera posicio- 
nado el cuadro. 


Slider gatti) Devuelve el objeto IU, que imple- 
menta la apariencia para este com- 
ponente. 

String getUlClassID() Obtiene el nombre de la apariencia 
que representa este componente. 

int getValue() Obtiene el valor del deslizador. 

boolean getValuelsAdjusting() Devuelve true sise arrastra elcuadro 


del deslizador. 


protected String paramString() Devuelve unacadena para represen- 
tar este objeto JSlider. 


void removeChangeListener(Change- Elimina un receptor de cambios del 
Listener %) deslizador. 


void setExtent(int extent) Asigna el tamaño de rango cubierto 
por el cuadro. 


void setinverted(boolean b) Pasa un valor JSlider para invertir el 
rango de valor. 


void setLabelTable(Dictionary labels) Utilizado para especificar qué eti- 
queta se dibujará en un valor dado. 


void setMajorTickSpacing(int n) Asigna el espaciamiento de marcas 
mayores. 
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Método 


void setMaximum(int maximum) 
void setMinimum(int minimum) 
void setMinorTickSpacing(intn) 


void setModel(BoundedRangeModel 
newModel) 


void setOrientation(int orientation) 


void setPaintLabels(boolean b) 
void setPaintTicks(boolean b) 
void setPaintTrack(boo1eanb) 


void setSnapToTicks(booleanb) 


void setUl(SliderUl ui) 


void setValue(int n) 


void setValuelsAdjusting(boolean b) 


protected void updateL abelUls() 


void updateUl() 


Descripción 


Asigna la propiedad máximo del 
modelo. 


Asigna la propiedad mínimo del 
modelo. 


Asigna el espaciamiento de marcas 
menores. 


Asigna el modelo que procesa las 
tres propiedades fundamentales de 
los deslizadores: mínimo, máximo y 
valor. 


Asigna la orientación de la barra 
desplazamientobiena VERTICAL o 
HORIZONTAL. 


Determina si se pintan etiquetas en 
el deslizador. 


Determinasi se pintan marcas en el 
deslizador. 


Determina si se pinta la pista del 
deslizador. 


Si especificamos true, el cuadro 
resolveráala siguienteposiciónmás 
cercana de las marcas donde se 
hubiera posicionado el cuadro. 


Asignael objeto IU, que implementa 
la aparienciapara este componente. 


Asigna valor actual del deslizador. 


Asigna la propiedad valuelsAdjus- 
ting del modelo. 


Llamada internamente para reem- 
plazar la interfaz de usuario de la 
etiqueta con las últimas versiones 
de la clase UlFactory. 


Notificación procedente de la clase 
UlFactory para indicar que la apa- 
riencia ha cambiado. 


Vamos a hacer funcionar la clase JSlider en un ejemplo. En este caso, 
crearemos justamente un deslizador que puede devolver valores desde O hasta 
100 e informar del valor actual en una barra de estado del applet. Aquí vemos 
cómo crear un deslizador horizontal con la constante SwingConstants.HOR]1- 
ZONTAL (como podrá suponer, la otra posibilidad es SwingConstants. VER- 
TICAL) con un valor mínimo de 0, un valor máximo de 100 y un valor inicial 
de O: 


import java.awt.*; 

import javax.swing.*; 

import java.awt.event.*; 
import javax.swing.event.*; 


public class slider extends JApplet implements ActionListener, 
ChangeListener 
1 
JSlider jslider = new JSlider (SwingConstants.HORIZONTAL, 0, 100, 0); 
JButton jbutton = new JButton ("Fijadala extensión de texto a 60"); 


public void inito0 


Ahora, en el método init, añadimos este deslizador al panel de contenidos 
del applet. Utilizaremos receptores de cambios con deslizadores y no recep- 
tores de ajuste, como hicimos con las barras de desplazamiento. El interfaz 
ChangeListener tiene únicamente un método, statechanged, que se muestra 
en la tabla 13.10. Añadimos un receptor de cambio al deslizador en este 
applet y después añadimos el deslizador como sigue: 


public void hito 
( 


Container contentpane = getContentPane0; 
contentPane.setlLayout (new FlowLayout ()); 


contantcPane.add(jolider); 


En el método statelhanged, utilizamos los métodos get=-inimumr 
getMaximum y getValue de JSlider para visualizar la configuración del 
deslizador en la barra de estado: 


public void stateChanged (ChangeEvent e) 
i 
JSlider jsliderl = (JSlider) e.getSource(); 
showStatusí"Deslizadormínimo: "+ Jsliderl.getMinimum ()+ 
", máximo: "+ Jsliderl .getMaximum) + 
+ Jsliderl.getValue()); 


*, valor: 


1 


El resultado se muestra en la figura 13.5. Como vemos, el usuario puede 
mover el selector del deslizador y aparece el nuevo valor. Este ejemplo se 
encuentra en el archivo slider.java del CD. 


Tabla 13.10. El método de la interfaz ChangeListener. 


Descripción 


void stateChanged(ChangeEvente)  Invocado cuando el destino del re- 
ceptor ha cambiado su estado. 


Figura 13.5. Uso de un deslizador. 


Relleno de un deslizador 


Si está utilizando la apariencia de metal predeterminada de Swing, puede 
rellenar sus deslizadores, lo que implica que su huella aparecerá rellena desde 
el origen hasta el selector del deslizador. Para hacerlo, debe asignar la pro- 
piedad cliente ¡isFilled del JSlider a true, lo que puede hacer como sigue 


(observe que estamos añadiendo este código al ejemplo del deslizador a partir 
del tema anterior): 


public void inití) 

( 
Container contentpane = getContentPane0; 
contentpane.setLayout (newFlowLayoutoO); 


El resultado aparece en la figura 13.6. Como puede ver, el deslizador de la 
figura está relleno. 


Figura 13.6. Relleno de un deslizador. 


Pintar las marcas de un deslizador 


"Ah", dice el programador novato, "los usuarios se quejan de los 
deslizadores en mi programa; dicen que no pueden conseguir lo que quieren 
utilizando un único deslizador largo”. 

"Bien", decimos, "puede arreglarlo añadiendo marcas". 

Para pintar las marcas en un control de deslizamiento, pasamos un valor 
de true al método setPaintTicks y después indicamos el desplazamiento ma- 
yor y menor que queremos para las marcas, utilizando los métodos 
setMajorTickSpacing y setMinorTickSpacing, como aquí (observe que esta- 
mos añadiendo este código al ejemplo del deslizador existente): 


public void inito0 
i 


Container contentpane = getContentPane0; 
contentPane.setLayout (new FlowLayoutO| ; 


El resultado aparece en la figura 13.7. Como se muestran la figura, el 
deslizador ahora muestra las marcas. 

También puede pintar los valores numéricos para las marcas mayores; 4 
consulte el siguiente tema para conocer los detalles. 


Dachradi minimo 0 aidaimo 200 valur 4d 


Figura 13.7. Pintar marcas en un deslizador. 


Pintar etiquetas en un deslizador 


Puede utilizar el método setPaintLabels de la clase JSlider para visualizar 
el valor numérico de las marcas mayores en el deslizador. Aquí vemos cómo 
hacerlo añadiendo una línea de código al ejemplo del deslizador existente: 


public void init () 

( 
Container contentpane = getContentPane0; 
contentPane.setLayout (new FlowLayout-”)); 


El resultado se muestra en la figura 13.8. Como vemos, se etiquetan las 
marcas mayores. 


Wise elche chars 


ú m LI m in 


[Declizador mínimo 0. máximo 100. valor 60 ] 


Figura 13.8. Pintar las etiquetas del deslizador. 


Ajuste de la extensión del deslizador 


Puede ajustar la extensión del deslizador, que limita el valor máximo de 
éste. Si ajusta la extensión del deslizador y su valor máximo es máximo, el 
valor de deslizador jamás podrá exceder al valor máximo - extensión. 

Como ejemplo, añadimos un botón al ejemplo deslizador que hemos desa- 


rrollado en los últimos temas para permitir que el usuario ajuste la extensión 
del deslizador a 60: 


public class slider extends JApplet implements -“ctionLi-tener, 
ChangeListener 


I 
JSlider jslider = new JSlider (SwingConstants.HORIZONTAL, 0, 100. 0); 
JButton jbutton = new --utton("Fijada extensión de texto a 60"); 


public void hitoO0 

( 
Container contentpane = getContentPane0; 
contentPane.setLayout (new FlowLayoutoO ); 


jslider.addChangeListener (this); 
jslider.putClientProperty("Jslider.isFilled", -oolean. TRUE); 
jslider.setPaintTicks (true); 

jslider.setPaintlabels (true); 

jslider .setMajorTickSpacing (20); 


t ti 


cootantFana. add (button) 


public void stateChanged (ChangeEvent e) 
I 
JSlider jsliderl = (JSlider) e.getSource0; 
showStatus ("Deslizador mínimo: " + jsliderl.getMinimum0 + 
", máximo: " + jsliderl .getMaximum() + 
, valor: " + jsliderl.getValue0 + 
, extensión: "+ jsliderl.getExtentO); 


public void actionPerformed(ActionEvent e) 


slider. setExtent | 


jalidar.cevalidatelb; 


Cuando el usuario hace clic sobre el botón, se ajusta la extensión de 
deslizador a 60 y debido a que su valor máximo es 100, eso significa qite su 
valor no puede superar 40. La figura 13.9 muestra el resultado. Observt zaue 
incluso aunque el deslizador esté ajustado a su valor máximo, su valor única- 
mente es 40. 


Apae viewer dies oler 


Driiado minima 0, mima 100, vor 40, eriensiór 10 


Figura 13.9. Ajuste de la extensión del deslizador. 


Creación de barras de desplazamiento 


"Bien", dice el programador novato, "quiero permitir al usuario recorrer 
los datos en mi programa. Quiero dejarle ajustar los valores. Quiero que 


pueda navegar por los elementos en una lista larga. Quiero...”. "Barras de 
desplazamiento", respondemos. "Lo que quiere son barras de desplazamien- 
to." "Correcto", dice el PN. 

El componente ligero de la Swing para barras de desplazamiento es la 
clase JScrollBar y su diagrama de herencia es como sigue: 


AVAX: Ewing: Component 


Puede encontrar los campos de la clase JScrollBar en la tabla 13.11, sus 
constructores en la tabla 13.12 y sus métodos en la tabla 13.13. 


Tabla 13.11. Campos de la clase JScrollBar. 


Campos Descripción 


protected int blockIncrement El incremento de bloque. 

protected BoundedRangeModelmodel Elmodeloquerepresentalos valores 
actual, mínimo, máximo y extensión 
de la barra de desplazamiento. 


protected int orientation Laorientación de labarra de despla- 
zamiento. 
protected int unitincrement El incremento unitario. 


Tabla 13.12. Constructores de la clase JScrollBar. 
Constructor Descripción 
JscrollBarí) Construye una barra de desplaza- 
miento vertical. 


JScrollBar(int orientation) Construye una barra de desplaza- 
miento con la orientación indicada y 
los siguientes valores iniciales. 


JScrollBar(int orientation, int value, Construye una barra de desplaza- 

int extent, int min, int max) miento con la orientación, valor, ex- 
tensión, y valores máximo y mínimo 
indicados. 


Tabla 13.13. Métodos de la clase JScrollBar. 


Metodo Descripción 


void addAdjustmentListener(Adjust- Añade un receptor de ajuste. 
mentListener )) 


Método 


protected void fireAdjustmentValue- 
Changed(int id, int type, int value) 


AccessibleContext getAccessible- 
Contexto 


int getBlockIncrement() 


int getBlockIncrement(int direction) 


int getMaximum() 


Dimension getMaximumSize() 
int getMinimum() 
Dimension getMinimumSize() 


BoundedRangeModelgetModel() 


int getOrientation() 


| ScrollBarUl getUl() 


String getUlClassID() 


int getUnitincrement() 


int getUnitincrement(int direction) 


Descripción 


Dispara un evento de ajuste. 
Obtiene el contexto accesible. 


Utilizado para compatibilidad con 
versionesanterioresúnicamentecon 
java.awt.ScrollBar. 


Obtiene la cantidad en que debe 
cambiarse el valor de la barra de 
desplazamiento, dado un bloque de 
petición de cambio. 


El valor máximo de la barra de 
desplazamiento es igual al valor 
máximo menos la extensión. 


Obtiene el tamaño máximo de la 
barra de desplazamiento. 


Obtiene el mínimo valor soportado 
por la barra de desplazamiento. 


Obtiene el tamaño mínimo de la 
barra de desplazamiento. 


Obtiene el modelo de datos que 
procesa las cuatro propiedades fun- 
damentales de la barra de despla- 
zamiento: mínimo, máximo, valor y 
extensión. 


Obtiene la orientación del compo- 
nente (horizontal o vertical). 


Obtieneeldelegadoque implementa 
la apariencia de este componente. 


Obtiene el nombre de la clase Look-! 
AndFeel para este componente. 


Utilizado para compatibilidad con 
versiones previas únicamente para 
java.awt.ScrollBar. 


Obtiene la cantidad que debe carn- 
biar el valor de la barra de despla- 


Método 


Descripción 


int getValue() 


boolean getValuelsAdjusting() 


int getVisibleAmount() 
protected String paramString() 


void removeAdjustmentListener 
(AdjustmentListener 7) 


void setBlockIncrement(int block- 
Increment) 


void setEnabled(boo1tean x) 
void setMaximum(int maximum) 
void setMinimum(int minimum) 


void setModel(BoundedRangeModel 
newModel) 


void setOrientation(int orientation) 


void setUnitincrement(int unitln- 
crement) 


Sets the unitIncrement property. 
void setValue(int value) 


void setValuelsAdjusting(boolean b) 


void setValues(int newvalue, int new- 
Extent, int newMin, int newMax) 


zamiento, dada una unidadde solici- 
tud de cambio. 


Obtiene el valor de la barra de des- 
plazamiento. 


Devuelve true, sise ha arrastrado el 
cuadro de la barra de desplaza- 
miento. 


Obtiene la extensión de la barra de 
desplazamiento. 


Obtiene una cadena que representa 
la barra de desplazamiento 


Elimina un receptor de Adjustment- 
Event. 


Asigna la propiedad blockIncrement. 


Habilita el componente para que la 
posición del cuadro pueda cambiar. 


Asignala propiedad máximo del mo- 
delo. 


Asigna la propiedad mínimo del mo- 
delo. 


Asigna el modelo que procesa las 
cuatro propiedades fundamentales 
de la barra de desplazamiento: míni- 
mo, máximo, valor y extensión. 


Asigna la orientación de la barra de 
desplazamiento a losvaloresVERTI- 
CAL u HORIZONTAL. 


Asigna la propiedad unitincrement. 


Asigna el valor de la barra de des- 
plazamiento. 


Asigna la propiedad valuelsAdjus- 
ting del modelo. 


Asigna las cuatro propiedades 
Bounded RangeModel. 


KEE 


Descripción 


void setVisibleAmount(int extent) Asigna la propiedad extensión del 


modelo. 


void update UI(O) SobrescribeJCornponent.updateU 1. 


Aquí tenemos un ejemplo en el que utilizamos una barra de desplazamien- Y 
to para desplazar texto en un applet. 


Para hacerlo, crearemos un nuevo panel que muestre una etiqueta con e7 
texto "¡Hola desde Swing!" en la posición vertical dada por el miembro 


público de datos denominado y. Aquí tenemos la apariencia de la clase del 
panel: 


class jpanel extends JPanel 
I 


JLabel jlabel = new JLabel (" ¡Hola desde la Swing!") ; 
int y = 0; 


jpanel() 

{ 
jlabel = new JLabel ("iHola desde la Swing!"); 
add (jlabel) ; 


public void paintComponent (Graphics g) 
( 


super .paintComponent (g); 


Jjlabel.setLocation(0, y); 


public void setScrolledPosition(int newposition) 
( 
y = newposition; 
1 
1 


Ahora podemos añadir un objeto de esta nueva clase panel a un applet, asl 


como una barra de desplazamiento vertical en una distribución de borde, 
como sigue: 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


public class scrollbar extends JApplet 


( 
private JScrollBar vsb = new JScroilBar (JScrollBar.VER--"c%7, 


O, 0, 180); 
private jpanel j = new jpanelo; 


public void init () 
{ 
Container contentpane = getContentPane (); 


goatentPanea-aid{j; BorderLaycut . CENTER} p 
contentFane. add ivab, BorderLayout. EAST} p 


vsb.addAdjustmentListener (new AdjustmentListenero 
1 
public void adjustmentValueChanged ( 
AdjustmentEvent e) ( 
JScrollBar sb = (JScrollBar)e.getSource (); 
j.setScrolledPosition (e.getValue ()); 
Jj. repaint ()5 


1); 


El resultado se muestra en la figura 13.10. Como muestra la figura, el 
usuario puede utilizar la barra de desplazamiento para mover el texto arriba y 
abajo en el panel. Este ejemplo se encuentra en el archivo scrollbar.java del 


CD. 
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Figura 13.10. Creación y uso de una barra de desplazamiento. 


Creación de listas 


El gran jefe aparece envuelto en una nube de humo de cigarro y dice, 
"Ahora tenemos 14.389 productos para que el usuario seleccione. ¿Cómo 
vamos a visualizarlos todos en un programa?". "Sin problema", responde- 
mos, "utilizamos un control de lista". El gran jefe sonríe y dice, "Aquí tiene 
los nombres de los productos para introducirlos”. 

La clase JList de la Swing es un control de lista de poco peso. Aquí 
tenemos el diagrama de herencia para la clase JList: 


java.lang.Object 

-java .awt . Component 
—-java.awt.Container 
—-javax.swing.JComponent 
=-javax.swing. JList 


Podemos hacer más con los controles JList de lo que podíamos con los 
controles List del AWT; por ejemplo, podemos visualizar imágenes en listas 
Swing. De hecho, examinaremos lo que podemos hacer con las listas Swing 
desde este punto hasta el final del capítulo. Puede encontrar los constructores 
de la clase JList en la tabla 13.14 y sus métodos en la tabla 13.15. 


Tabla 13.14. Constructores de la clase JList. 


Constructor Descripción 


JList() Construye un objeto JList. 


JList(ListModel dataMode1) Construyeun objeto JList, quevisua- 
lizarálos elementos en el modelode 
datos indicado. 


JList(Object[] listData) Construye un objeto JListquevisua- 
licelos elementos en la matrizindica- 
da. 


JList(Vector listData) Construye un objeto JListquevisua- 
lice los elementos en el vectorindica- 
do. 


Tabla 13.15. Métodos de la clase JList. 


Método Descripción 


void addListSelectionListener(List- Añade un receptor de selección. 
SelectionListener listener) 


an 
b 
Ti 


Método 


void addSelectionInterval(int anchor, 
int lead) 


void clearSelection() 


protected ListSelectionModel create- 
SelectionModel() 


void ensurelndexlIsVisible(int index) 


protected void fireSelectionValue- 
Changed(int firstindex, int lastindex, 
boolean isAdjusting) 


AccessibleContext getAccessible- 
Contexto 


int getAnchorSelectionindex() 


Rectangle getCellBounds(int indexl, 
int index2) 
ListCellRenderer getCellRendererO 


int getFirstVisiblelndex() 


int getFixedCellHeight() 


int getFixedCellWidth() 


int getLastVisiblelndex() 


int getLeadSelectionindex() 


Descripción 


Hace que la selección sea la unión 
del intervaloindicadocon laselección 
actual. 


Borra la selección. 


Obtiene una instancia de Default- 
ListSelectionModel. 


Desplaza el viewportpara asegurar 
que un elemento sea visible. 


- Notificaalos receptoresde selección 


de la lista JList que el modelo de se- 
lección ha cambiado. 


Obtiene el contexto accesible. 


Obtiene el argumento del primer 
índice a partir de la llamada addSe- 
lectioninterval o setSelectionInterval 
más reciente. 


Obtiene los límites del rango de ele- 
mentos indicado. 


Obtiene el objeto que renderiza la 
lista de elementos. 


Devuelve el índice de la celda en la 
esquinasuperiorizquierdadel objeto 
JList. 


Obtiene el valor de altura fija de la | 
celda. 


Obtiene el valor de anchura fija de la 
celda. 


Devuelve el índice de la celda en la 
esquina inferior derecha del objeto 
JList. 


Obtiene el argumento del segundo 
índice a partir de la llamada addSe- 
lectionInterval o setselectionInter- 
val más reciente. 


Mét odo 


int getMaxSelectionIndex() 
int getMinSelectionindex() 


Lisiódodel getWModel() 


Dimension getPreferredScrollable 
ViewportSize() 


Object getPrototypeCellValue() 


intgetScrollableBlockIncrement(Rec- 
tangle visibleRect, int orientation, int 


direction) 


boolean getScrollableTracksView- 


portHeight0 


boolean getScrollableTracksView- 
portWidth() 


int getScrollableUnitincrement(Rec- 
tangle visibleRect, int orientation, 
int direction) 


int getSelectedIndex() 


int] getSelectedindices/) 


Object getSelectedValue() 


Object] getSelectedWalues() 


Color getSelectionBackgrouna() 


| Color getSelectionForeground() 


Descripción 


Obtiene el índice máximo de la celda 
seleccionada. 


Obtiene el índice mínimo de la celda 
seleccionada. 


Obtiene el modelo de datos que 
contiene la lista de elementos de 
datos. 


Calcula eltamaño delviewportnece- 
sario para visualizar visibleRow- 
Count filas. 


Obtiene el ancho de celda de la cel- 
da prototipo (unaceldautilizadapara 
el cálculo de anchos de celdas). 


Obtiene la cantidad de incremento 
de bloque. 


Obtiene la altura de la pista del 
viewpori. 


Obtiene el ancho de la pista del 
viewpori. 


Devuelve el tamaño del tipo de letra 
de la lista 


Devuelve el índice del primer se- 
leccionado. 


Devuelve una matriz con todos los 
índices seleccionados en orden cre- 
ciente. 


Devuelve el primer valor seleccio- 
nado o nulo, si no hay selección. 


Devuelve una matriz de valores para 
las celdas seleccionadas. 


Obtiene el color de fondo de las 
celdas seleccionadas. 


Obtiene el color de primer plano. 


| Metodo 


Descripción 


int getSelectionMode() 
ListSelectionModel getselection- 
Modelo 

ListUl getUl() 


String getUlClassID() 


boolean getValuelsAdjusting() 


int getVisibleRowCount() 


Point indexToLocation(int index) 


boolean isSelectedindex(int index) 


boolean isSelectionEmpty() 


int locationTolndex(Point location) 


protected String paramString() 


void removeListSelectionListener 
(ListSelectionListener listener) 


void removeSelectionInterval 
(int index0, int indexl) 


Obtiene si están permitidas o no las 
listas simples o múltiples. 


Obtiene el valor del modelo de se- 
lección actual. 


Obtiene la apariencia que renderiza 
este componente. 


Obtiene el nombre de la clase 
UlFactory que genera la apariencia 
para este componente. 


Obtiene el valor de la propiedad 
valuelsAdjusting del modelo de 
datos. 


Devuelve el número preferido de 
filas visibles. 


Obtiene el origen del elemento 
indicado en coordenadas de JList. 
Devuelve nulo si el índice no es 
válido. 


Devuelve true si el índice seleccio- 
nado es el indicado. 


Devuelve true si no hay nada 
seleccionado. Es un método 
conveniente que únicamente delega 
en el modelo de selección. 


Convierte en un punto en coor- 
denadas JList al índice de la celda 
en esa localización. 


Obtiene una representación de 


cadena de este objeto JList. 
| 


Elimina al receptor de la lista que re- 
cibe notificacióncada vez queocurra 
un cambio en la selección. 


Establece la selección paraque sea | 
la diferencia como conjunto del 
intervalo indicado y la selección 
actual. 


Método 


Descripción 


void setCellRenderer 
(ListCellRenderer cellRenderer) 
void setFixedCellHeight(int height) 
void setFixedCellWidth(int width) 


void setListData(Object[] listData) 


void setListData(Vector listData) 


void setModel(ListModel model) 


void setPrototypeCellValue 
(Object prototypeCellValue) 


void setSelectedindex(int index) 


void setSelectedIndices(int[Jindices) 


void setSelectedValue(Object 
anobject, boolean shouldScroll) 


void setSelectionBackground 
(Color selectionBackground) 


void setSelectionForeground 
(Color selection Foreground) 


void setSelectionInterval(int 
anchor, int lead) 


void setSelectionMode 
(int selectionMode) 


void setSelectionModel 
(ListSelectionModel selectionModel) 


void setUl(ListUl ui) 


Asigna el delegado que se utiliza 
para pintar cada celda de la lista. 


Define la altura de todas las celdas 
de la lista. 


Definela anchuradetodas las celdas 
de la lista. 


Construye un modelo de lista a partir 
de una matriz de objetos y después 
aplica el setModel al modelo. 


Construye un modelo de lista a partir 
de un vector y después aplica 
setModel. 


Asigna al modelo que representa 
los contenidos de la lista y limpia la 
selección. 


Utilizado para calcular fixedcel!- 
Width y fixedCellHeight. 


Selecciona una única celda. 
Selecciona un conjunto de celdas. 


Selecciona el objeto indicado de la 
lista. 


Asigna el color de fondo para las 
celdas seleccionadas. 


Asigna al color de primer plano para 
las celdas seleccionadas. 


Selecciona el intervalo indicado 


Determina si están permitidas ls 
selecciones simples o múltiples 


Asigna al modelo de selección pará 
la lista a la implementación no rbula 
del modelo de selección ListSelec- 
tionModel. 


Asigna el objeto que renderiza la 
apariencia de este componente. 


Metodo Descripción 


void setValuelsAdjusting(boolean b)  Asigna la propiedad isAdjusting del 
modelo de datos a true. 


void setVisibleRowCount Asigna el número preferido de filas 

(int visibleRowCount) en la lista que puede visualizarse 
sin una barra de desplazamiento. 

void update Ul() Asigna la propiedad TU con el objeto 
ListUl a partir de la clase UlFactory 
predeterminada. | 


beaam 


Observe que puede obtener el índice del elemento seleccionado actual- 
mente con el método getSelectedIndex de la clase JList, selecciones múlti- 
ples con getSelectedIndices, el elemento seleccionado actualmente con 
getSelectedValue y los elementos seleccionados en el momento con 
getSelectedValues. 


Truco: Una cosa a tener en cuenta es que los datos de la lista los | 
rnantiene realmente su modelo, por ltz que si deseamcis acceder m un 
elemtrnto que no está selec ~i oade, podlemos uti lizar el mëtmdao permModel 
de la CSE 1 para votener el modelo y después el método 
gelElementAt del m0 ielo para conseguir el elemento real, | 


Haremos funcionar la clase JList en éste y los temas siguientes. Para 
comenzar, crearemos un ejemplo sencillo JList que únicamente visualice 12 
elementos e informe sobre cuál de ellos se ha hecho clic. Comenzaremos 
creando un control de lista que contendrá esos elementos: 


import java.awt.*; 
import jJavax.swing.*; 
import javax.swing.event.*; 


public class list extends JApplet implements -istSelectionListener 


{ 
JList jlist; 
public void init () 
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Container contentpane = getContentPane0; 
String[1 items = new String[12]; 


loop-index++) { 
"y 


for (int loop—-index = 0; loop—index <= 11; 
= "Elemento " + loop-index; 


items [1loop-indexl 


1 


jlist = new JList (items); 


Después, añadimos este control de lista a un panel de desplazamiento para 


permitir el desplazamiento, lo configuraremos para que visualice cinco filas 
y añadiremos un receptor de selección para él: 


public void init () 
{ 


Container contentpane = getContentPane0; 
String[1 items = new String[12]; 


for (int loop—index = 0; loop—index <= 11; loop-index++) ( 
items [loop-index] = "Elemento " + loop—index; 


1 


jlist = new JList (itemsl; 
JScrollPane jscrollpane = new --croll-ane(Jlist); 
jlist.setVisibleRowCount (5); 


jlist.add-ist-r-election-istener(thi-); 


ntentPane.serLayout [new FlowLayout i 


costentPFanes,addijoorolipane) ; 


Ahora, en el método valuechanged, podemos utilizar el método 
getSelectedIndex para obtener el elemento sobre el que ha hecho clic el 
usuario y visualizar el número del elemento en la barra de estado: 


public void valueChanged (ListSelectionEvent e) 

( 
String outstring = 'r“eleccionóel elemento: "3; 
outstring += jlist.getSelectedIndex-); 


showStatus (outString) ; 
1 


Eso es todo lo que hace falta. Ahora, cuando el usuario hace clic sobre un 
elemento de la lista, el applet visualiza sobre qué elemento se ha hecho clic, 


como se muestra en la figura 13.11. Este ejemplo se encuentra en el archivo 
list-javadel CD. 


Observe, sin embargo, que existe más de una forma de seleccionar ele- 
mentos en una lista; puede realizar selecciones múltiples también sobre lis- 
tas. Examine el siguiente tema para conocer los detalles. 


Iseleccionó el elemento 5 


Figura 13.11. Gestión de selecciones en un control de lista. 


Gestión de selecciones múltiples 


Aparece el especialista de soporte a productos y comenta: "A los usuarios 
no les agrada el nuevo programa. Quieren reordenar doce productos a la vez, 
pero el control de lista del programa únicamente les permite ordenar uno". 
"iA Hsí?”, preguntamos. "Por tanto el gran jefe va a ser muy infeliz", dice el 
ESP. "Bien", decimos, "configuraremos un control de lista de selección múl- 
tiple". 


Modos de selección de lista 


Por defecto, existen tres modos de selección para los objetos JList y 
podemos asignar el deseado con el método setSelectionMode. Aquí tenemos 
los constantes que podemos pasar a este método y lo que significan: 

e SINGLE-SELECTION. Selección simple. 


+ SINGLEINTERVAL-SELECTION. Selección en un intervalo. El usua- 
rio puede seleccionar un único intervalo con elementos. 


e MULTIPLE-INTERVAL-SELECTION. Intervalos de selección múl- 
tiple. 


Crearemos un control de lista de selección con intervalo múltiple y mos- 
traremos cómo determinar qué elementos están seleccionados cuando el usuario 
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realiza una selección. Para comenzar, vamos a crear un control de lista como 
en el tema anterior, convirtiéndolo en un control de lista de selección de 
intervalo múltiple. Aquí tenemos el código: 


import java.awt.*; 
import Javax.swing.*; 
import Javax.swing.event.*; 


public classlistmultipleextends JApplet implements ListSelectionListener 


{ 
JList jlist; 


public void init () 

{ 
Container contentpane = getContentPane0; 
String[] items = new String[12]; 


for (int loop—index = 0; loop—index <= 11; loop-index++) { 
items[loop-index] = "Elemento " + loop—index; 


1 


jlist = new JList(items); 
JScrollPane jscrollpane = new JScrollPane (jlist); 
jlist.setVisibleRowCount (5); 


jlist.set-election-ode(-ist-electionModel.M-+--=-=-PLE=-=="3ooo- 


jlist.add-istSelectionListener (this); 


Ahora, cuando el usuario realiza una selección, podemos determinar qué 
elementos fueron seleccionados en el método valuechanged, utilizando el 
método getSelectedIndices, que devuelve una matriz con los índices seleccio- 


nados. El resultado final es que podemos informar de estos índices en la barra 
de estado del applet, como sigue: 


public void value-han-ed (-istSelectionEves)t 
i 
int[] indexes = jlist.get-electedIndices0Q 
String outstring = "Su selección:"; 


for (int loop—index = 0; loop—index < indexec.length; loop-index++) ( 
outstring += " elemento + indexec[loop-index]; 


1 
showstatusioutStrins); 


1 


El resultado se muestra en la figura 13.12. El usuario puede hacer clic 
sobre un elemento para seleccionarlo y después utilizar la tecla Control para 
seleccionar otros elementos, o la tecla Mayús para seleccionar un intervalo 
de elementos. Siempre y cuando se realice una selección, el applet informa de 
la selección en su barra de estado, como se muestra en la figura 13.12. Este 
ejemplo es un éxito y aparece en el archivo listmultiple.java del CD. 


Elermaria ] 


A |= 
a 


u selección. elemento 1 elemento 3 elemento 4 


Figura 13.12. Gestión de selecciones múltiples en un control de lista. 


Visualización de imágenes en listas 


"Tenemos que mejorar las cosas”, dice el gran jefe, "la competencia está 
siendo demasiado dura". "Bien", preguntamos, "¿qué tal si añadimos más 
funcionalidades?". "Eso cuesta dinero”, ruge el gran jefe. "Ajá", decimos, 
"supongo que podríamos visualizar imágenes en los controles de lista". "Per- 
fecto", dice el gran jefe, "hagámoslo". 

Hacer que un control de lista de la Swing visualice imágenes no es tan 
fácil como añadir imágenes a una etiqueta de la Swing. En particular, tene- 
mos que crear nuestro propio modelo y nuestra propia clase de volcado para 
el control de lista y lo haremos aquí. El resultado que buscamos se muestra en 
la figura 13.13. Este ejemplo se encuentra en el archivolistimages.java del CD. 

Para gestionar imágenes en un control de lista, crearemos un nuevo mode- 
lo de control de lista, newModel, y un nuevo control de lista para volcar 
celdas, newRenderer. Para instalar el nuevo modelo, que contendrá la cadena 
de cada elemento de lista y el icono de imagen para cada uno de ellos, 


podemos pasar un objeto de la clase newModel al constructor JList. Para 
instalar el nuevo volcador, podemos utilizar el método setCellRenderer. Aquí 
tenemos el código: 

import java.awt.”*; 


import javax.swing.*; 
import java.awt.event.*; 


lasg 
5 7 
HEILGAT=300 


APPLET> 


public class listimages extends JApplet 
{ 


public void init0 
I 


Container contentpane = getContentPane0; 


newModel newrnodel = new newModel0; 
newRenderer newrenderer = new newRenderer0; 


JList jlist = new JList (newrnodel); 
jlist .setCellRenderer (newrenderer) ; 


jlist.setVisibleRowCount (6); 


conteniFane.add inaw JScrollPaneijlisti); 


LIET ITEM 
LIET ITEM 
LIET ÍTEM mu 


LIST ITEM =p 


LIET ITEM 


Applet staried 


Figura 13.13. Adición de imágenes a un control de lista. 


Esto instala el nuevo modelo y renderizodor; lo único queda realmente e 4 
crear las clases correspondientes y lo haremos en los dos temas siguientes. 


Creación de un modelo de lista personalizado 


La creación de un nuevo modelo para una lista no es difícil; todo lo que 
tenemos que hacer es almacenar nuestros datos utilizando el método 
addElement. En este caso, crearemos el nuevo modelo para el ejemplo de 
lista del tema anterior, que visualizará imágenes y texto en un control de 
lista. 

En este caso, solamente haremos que cada elemento del modelo sea una 
matriz de dos elementos; el primer elemento de la matriz contendrá el texto 
para el elemento de lista y el segundo elemento de la matriz contendrá el 
icono de imagen para el elemento de lista. Aquí tenemos el código: 


class newModel extends DefaultListModel 
I 
public newModel () 


( 
foríint loop—index = 0; loop—index <= 12; loop-index++) ( 
addElement (new Object[1 ("Elemento ' 4 loop—index, 
new ImageIcon ("item.jpg")}); 


1 


Esto es todo. Ahora hemos creado un nuevo modelo para un control de 
lista. Para dibujar realmente el icono de la imagen, sin embargo, tenemos que 
procesar nosotros mismos el volcador de la celda. Lo haremos en el tema 
siguiente. 


Creación de un renderizadorpersonalizado 
para celdas de lista 


Cada elemento de lista es realmente de clase JLabel, por lo que podemos 
utilizar los métodos de JLabel, como setText y setlcon, para visualizar imá- 
genes en las celdas de la lista. 

Aquí, lo haremos mediante la creación de un nuevo renderizador de celda 
que dibujará los elementos en la lista que ya hemos desarrollado en los dos 
temas anteriores. Para crear un renderizador de celdas, tenemos que 
implementar la interfaz ListCellRenderer, que tiene únicamente un método: 
getListCellRendererComponent. Este objeto recibe el objeto a volcar (que en 
este caso es la matriz bidimensional que contiene el texto e icono del elemen- 
to) y devuelve un renderizador de celda. Aquí tenemos el resultado del 


código (observe que también indicamos si está seleccionado un elementq 
asignando su fondo): 


class newRenderer extends JLabel implements ListCellRenderer 


{ 


public newRenderer0 


{ 
setopaque (true); 


) 


public Component getListCellRendererComponent ( 
JList jlist, Object obj, int index, boolean isselected, 
boolean focus) 


newModel model = (newModel)jlist.getModel(); 


setTexti (String) ((ObjectL1) 0b3) [011; 
setIconi (Icon)((Object [])0b3) [1]) ; 


return this; 


) 


Eso es todo. Ahora el control de lista visualizará imágenes, como sq 
muestra en la figura 13.13. Este ejemplo se encuentra en el archivo 
listimages.javadel CD. 


Procesamiento de doble clic en listas 


Dice el programador novato: "Quiero permitir que el usuario lance d 
elemento desde un control de lista al hacer doble clic sobre él, pero el método 
valuechanged de la interfaz ListSelectionListener se llama para clics senci- 
110s y no puedo decir si la lista ha recibido un clic doble". "Bien", decimos, 
"Puede utilizar los clics del ratón para interceptarlos clics dobles". El progra- 
mador novato dice, "¿De verdad? ¡Dígame más!" 

Si interceptamos los eventos de ratón, podemos determinar el número del 
clics de ratón y, accediendo al modelo de la lista, podemos determinar cuál 
fue el elemento sobre el que se hizo clic. 
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Vamos a verlo en el código. Aquí, únicamente añadimos una lista con 
varios elementos a un applet y después añadimos un receptor de ratón a la 
lista: 


import java.awt.*; 
import Javax.swing.*; 
import jJava.awt.event.*; 


public class listdouble extends JApplet implements MouseListener 
{ 
public void init() 


( 


Container contentpane = getContentPane0; 


String[] items = ("Elemento 1", "Elemento 2”, "Elemento 3", 

"Elemento 4", 
"Elemento 5", "Elemento 6", "Elemento 7”, 

"Elemento E”, 
"Elemento 9", "Elemento lo", "Elemento 11", 


"Elemento 12"); 


JList list = new JLiStiitemS); 


list. addMocaaListanar (this); 


Ahora, en el método mouseClicked, determinamos dónde se hizo doble 
clic con el ratón; entonces utilizamos el método locationToTndex de la lista 
para determinar el elemento de la lista sobre el que se hizo clic. Finalmente, 
podemos determinar cuántas veces se hizo clic sobre el elemento con el 
método getClickCount de MouseEvent y, por tanto. informar del número de 
veces que se hizo clic sobre un elemento, como a continuación: 


public void mouseClicked (MouseEvent e) 


( 
JList jlist = (UList)e.getSourceo0; 
int index = jlist.locationTolndex(e.get-oint0) 


String outstring = new String("Número de clics para el elemento' 
+#imiex + "ıı " + a. getClickCount i)i y 


EbowEtätis [outEtring] i 


public void mouseEntered (MouseEvent e) {} 

public void mouseExited (MouseEvent e) (1 

public void mousePressed (MouseEvent e) (1 

public void mouseReleased (MouseEvent e) I) 
1 


El resultado se muestra en la figura 13.14. Como vemos, el applet informa? 
del número de clics que se realizan sobre un elemento de lista cada vez. De 
esta forma, podemos manejar clics dobles e incluso triples. Este ejemplo se 
encuentra en el archivo listdouble.javadel CD. 


Fierraria E 
Flerrasia T 


Femara H ll 


I ~umerde clicc para el elemento Elemento 4 2 


Figura 13.14. Gestión de doble clic en un control de lista. 


m Swing: barras, 
herramientas, 
cuadros, 
separadores 


y selectores 


En este capítulo, veremos algunos controles importantes de la Swing: 
cuadros combinados, barras de progreso, separadores y selectores. También 
examinaremos la adición de herramientas de ayuda, unas pequeñas ventanas 
que muestran un texto de explicación cuando dejamos el ratón sobre un 
control. Todos estos temas, especialmente los cuadros combinados, son im- 
portantes en Java y los introduciremos antes de profundizar en el código. 


Cuadros combinados 


Los cuadros combinados son uno de los controles más importantes en la 
programación de la IU, pero el AWT no tiene un cuadro combinado. La 
Swing rectifica esto. Los cuadros combinados con combinaciones de campos 
de texto y listas desplazables. Son muy útiles, ya que permiten al usuario 
tanto seleccionar un elemento de la lista como introducir su propio valor en el 
campo de texto. Los cuadros combinados también son controles muy com- 
pactos, debido a que muestran únicamente un elemento y un botón que el 


usuario puede utilizar para desplegar la lista de otros elementos. Los cuadros 
combinados pueden funcionar como listas desplegables, proporcionando al 
usuario un mecanismo incluso aún más compacto para visualizar los elemen- 
tos de una lista que el que proporciona un cuadro de lista, y han pasado a ser 
muy populares por esa razón. De hecho, la Swing tiene como valor predeter- 
minado del cuadro combinado que muestre únicamente una lista desplegable, 
ya que el valor predeterminado para los cuadros combinados sería hacerlos 
no editables, lo que los convierte en listas desplegables. 


Barras de progreso 


Las barras de progresos son controles relativamente nuevos, que se han 
hecho populares como mecanismo para proporcionar al usuario la indicación 
del progreso de una operación larga. Las barras de progreso, originalmente 
introducidas como mecanismo para mostrar el progreso de un programa de 
instalación, se utilizan ahora para todo tipo de operaciones de consumo de 
tiempo, como descargas de archivos desde la red Internet. Las barras de 
progreso muestran una barra coloreada dentro de ellas que crece (o se redu- 
ce), de forma similar a como lo hace el mercurio en un termómetro, para 
mostrar visualmente cómo progresa una operación. Puede orientar las barras 
de progreso tanto horizontal como verticalmente, seleccionar los colores y 
etiquetas que use en ellas y manejar sus eventos. Y aún más, las barras de 
progreso siguen siendo controles sencillos, ya que tienen únicamente una 
función: mostrar el progreso de una tarea. Examinaremos todas sus posibili- 
dades en este capítulo. 


Selectores 
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Como en la AWT, la Swing soporta cuadros de diálogo. Al contrario que 
la AWT, la Swing también soporta adicionalmente varios cuadros de diálogo 
que no tenemos que crear o personalizar nosotros mismos: selectores de 
archivos y selectores de color. Los selectores de archivos permiten al usuario 
seleccionar un archivo para abrir o guardar algo, muy similar a cualquier 
cuadro de diálogo de archivos estándar. Los selectores de color permiten al 
usuario seleccionar un color entre muchos. Ambos selectores representan 
cuadros de diálogo estándar y Sun únicamente nos ahorra tiempo al crearlos. 
Trabajaremos con ambos selectores en este capítulo. Podemos utilizar inme- 
diatamente en los programas el selector de color, pero para utilizar los archi- 


vos que devuelve el selector de archivos, tendremos que esperar unos pocos 
capítulos (hasta que comencemos a trabajar con archivos). 


Herramientas de ayuda 


Las herramientas de ayuda son esas ventanas pequeñas que aparecen y 
muestran un texto de explicación (como por ejemplo Descargar ahora o Abrir 
nueva carpeta) cuando se detiene el ratón sobre un control. Las herramientas 
de ayuda pueden ser muy útiles debido a que los usuarios de la IU tienen una 
gran resistencia a leer los manuales. Lo único que tiene que hacer el usuario 
es dejar el ratón sobre su programa para ver qué es lo que hacen los distintos 
controles. Por otro lado, tenga en cuenta que muchas herramientas de ayuda 
(conectadas con muchos elementos de texlo en un control de texto, por 
ejemplo) pueden ser contraproducentes y dar una apariencia de dificultad a su 
programa. 


Separadores 


Los separadores son barras horizontales o verticales que le permiten orga- 
nizar sus controles en grupos. Aunque se utilizan mayoritariamente en los 
menús para dividir elementos de menú en agrupaciones lógicas, podrá utili- 
zar separadores en componentes JApplet y JFrame como cualquier otro con- 
trol, como veremos más adelante. 

Este es el resumen de lo que aparece en este capítulo. Como puede ver, 
vendrá mucho más. Es el momento de pasar al primer punto que comienza 
con los cuadros combinados. 


Creación de cuadros combinados 


"Mmh", dice el programador novato, "quiero permitir al usuario seleccio- 
nar una palabra para realizar un análisis sintáctico a partir de una lista de 
palabras, pero ahora los usuarios dicen que quieren introducir sus propias 
palabras también". "Suena razonable, ¿qué tal si utiliza un cuadro combina- 
do?" "Bien", dice el PN, "¿puede añadir uno a mi código?"”. 

Los cuadros combinados se pueden utilizar en la Swing de dos formas: 
como cuadros combinados normales y como listas desplegables. Las listas 
desplegables permiten al usuario seleccionar en una lista que aparece cuando 
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hace clic sobre la flecha que apunta hacia abajo. Los cuadros combinados 
normales, por otra parte, son combinaciones de campos de texto y listas 
desplegables; los usuarios pueden seleccionar un elemento de la lista desple- 
gable o introducir su propio texto en el campo de texto. Observe que al 
contrario de los cuadros de lista, únicamente se puede seleccionar un elemen- 
to a la vez en un cuadro combinado. 

Los cuadros combinados están soportados por la clase JComboBox en la 
Swing y aquí tenemos el diagrama de herencia para esta clase: 


2. 541100 00m 


La tabla 14.1 muestra los campos de la clase JComboBox, la tabla 14.2 
muestra sus constructores y la tabla 14.3 sus métodos. 

Los datos actuales del cuadro combinado se almacenan en su modelo, que 
es un objeto de la clase DefaultComboBoxModel predeterminado. Puede 
encontrar los métodos de este objeto en la tabla 14.4. Observe que para añadir 
o eliminar elementos, puede utilizar los métodos del modelo, como se mues- 
tra en la tabla. Para obtener el objeto del modelo, puede utilizar el método 
getModel del JComboBox. 


Tabla 14.1. Campos de la clase JComboBox. 


Descripción 


protected String actioncommand H comando de acción. 

protected ComboBoxModel El modelo de datos. 

dataModel 

protected ComboBoxEditoreditor H editor, que e s responsable del campo 
de texto. 

protected boolean isEditable Indica s el cuadro combinado e s edita- 
ble. 

protected JComboBox.Key H gestor de selección de teclas. 

SelectionManager keyselection- 

Manager 


protected boolean lightWeight Indicasi la lista desplegable está habili- 
PopupEnabled tada como componente de poco peso. 


Descripción 


protected int maximumRowCount Contiene la cuenta de filas. 


protected ListCellRenderer El renderizador de celdas. 

renderer 

protected Object selectedltem Unrecuerdo delelementoseleccionado. 
Reminder 


AAA 


Tabla 14.2. Constructores de la clase JComboBox. 


Constructor Descripción 

JComboBox() Construye un objeto JComboBox. 

JComboBox(ComboBoxModel Construye un objeto JComboBox que 

aModel) toma elementos de un modelo de 
cuadro combinado ya existente. 

JComboBox(Object[] items) Construye un objeto JComboBox que 
contiene los elementos en la matriz 
indicada. 

JComboBox(Vector items) Construye un objeto JComboBox que 
contiene los elementos en el vector 
indicado. 


Tabla 14.3. Métodos de la clase JComboBox. 


Método Descripción 

void actionPerformed Público como implementación de un 

(ActionEvent e) efecto lateral. 

void addActionListener Añade un receptor de acciones. 

(ActionListener 9 

void addltem(Object anobject) Añade el elemento a la lista de ele- 
mentos. 


void addltemListener(ltemListener Añade un receptor de elementos. 
alistener) 


void configureEditor(ComboBox  Inicializa el editor. 

Editor anEditor, Object anltem) 

void contentschanged Público como implementación de un 
(ListDataEvent e) efecto lateral. 


| Método 


Descripción 


protected JComboBox.Key 
SelectionManager createDefault 
KeySelectionManager() 


| protected void fireActionEvent() 


protected void fireltemstate 
Changed(1temEvent e) 


AccessibleContext getAccessible 
Contexto 


String getActionCommand() 
ComboBoxEditor getEditor() 


Object getltemAt(int index) 
int getltemCount() 


JComboBox.KeySelectionManager 
getKeySelectionManager() 


int getMaximumRowCount() 


| ComboBoxModel getModel() 
ListCellRenderer getRenderer() 
int getSelectedIndex() 


Object getSelectedltem() 
Objeci[] getSelectedObjectal) 
Combo oxUl qe) 


String getUlClassID() 


Obtiene en instancia del gestor de se- 
lección de teclas predeterminado. 


Notifica atodos los receptores que han | 
registrado interés en la notificación de | 
este tipo de evento. 


Notifica atodos los receptores que han 
registrado interés para la notificación 
en este tipo de evento. 


Obtiene el contexto accesible. 


Obtiene el comando de acción. 


Obtiene el editor utilizado para editarel 
elemento seleccionado del campo de 
texto JComboBox. 


Obtiene la lista de elementos en el 
índice indicado. 


Obtiene los elementos de la lista. 


Obtiene el gestor de selección deteclas 
de la lista. | 


Obtiene el máximo número de elemen- 
tos que puede visualizar a la vez un 
cuadro combinado. 


Obtiene el modelo de datos. 
Obtiene el renderizador. 


Obtiene el índice del elemento 
actualmente seleccionado. 


Obtiene el elemento seleccionado 
actual. 


Obtiene una matriz que contiene los | 
elementos seleccionados. 


Obtiene el objeto apariencia que 
renderiza este componente. 


Obtiene el nombre de laclase apariencia 
que renderiza éste componente. 


Método Descripción 


void hidePopup() Provoca que el cuadro combinadocierre 
su ventana emergente. 

void insertltemAt(Object Inserta elementosen la lista de elemen- 

anobject, int index) tos en un índice dado. 

protected void installAncestor Instala un receptor padre. 

Listener() 

void intervalAdded Invocadocuandolos elementos se aña- 

(ListDataEvent e) den al modelo de datos interno. 

void intervalRemoved Invocadocuando los valores se han eli- 

(ListDataEvent e) minado de un modelo de datos. 

boolean isEditable() Devuelvecierto si el objeto JComboBox 
es editable. 

boolean isFocusTraversable() Devuelvecierto si elcomponentepuede 
recibir el foco. 

boolean isLightWeight- Devuelvecierto si los cuadros emergen- 

PopupEnabled() tes de poco peso se utilizan. Devuelve 
falso si se utilizan diálogos emergentes 
de más peso. 

boolean isPopupVisible() Determina la visibilidad del cuadro 
emergente. 


protected String paramString() Obtiene una representación de cadena 
para este objeto JComboBox. 


void processKeyEvent(KeyEvente) Procesa a eventos de teclas, buscando 


la tecla Tab. 
void removeActionListener Elimina un receptor de acción. 
(ActionListener 7) 
void removeAllltems() Elimina todos los elementos de la lista 


de elementos. 


void rernoveltem(Object anobject) Elimina un elemento de la lista de 
elementos. 


void rernoveltemAt(int anindex) Elimina elemento en el index. Este 
métodofunciona únicamente si el objeto 
JComboBox utiliza el modelo de datos 
predeterminado. 


void rernoveltemListener Elimina al receptor de elementos. 
(ItemListener aListener) 


Metodo Descripción 


protected void selectedltemchan- Llamado cuando cambia el elemento 


gedi) seleccionado. 

boolean selectWithKeyChar(char Selecciona el elemento de la lista que 

keyChar) corresponde al carácter de teclado indi- 
cado. 

void setActionCommand(String Asigna el comando de acción que de- 

acommand) bería incluirse en el evento enviado a 


los receptores de acción. 
void setEditable(boolean aFlag) Asigna el indicador de edición. 


Tabla 14.4. Métodos de la clase DefaultCornooBoxModel. 


Método Descripción 


void addElement(Object anobject) Añade un elemento al final del modelp. 
| Object getElementAt(int index) Obtiene el valor en el índice indicado. 


int getIndexOf(Object anobject) Obtiene la posición del índice del objeto 
indicado en la lista. 


Object getSelectedltem() Devuelve el elemento seleccionado. 
int getSize() Obtiene la longitud de la lista. 


void insertElementAt(Object anOb- Añade un elemento al final del modelo. 
ject, int index) 


void removeElementAt(intindex) Elimina un elemento en un índice espe- 
cífico. 


void setSelectedltem(Objectan-  Asigna el elemento seleccionado. 
Object) 


Para añadir elementos a un cuadro combinado, puede utilizar el convei 
niente método addltem, pasándole un objeto que a su vez pasará a su modelo 
interno. Veamos un ejemplo que muestra cómo funciona. En este caso, basta 
crear un cuadro combinado y cinco elementos (es decir, cinco objetos String). 
Aquí tenemos el código: 


import java.awt.*; 
import javax.swing.*; 


E 
<APPLET 
CODE = combobox.class 


WIDTH = 200 
HEIGHT = 200 > 
</APPLET> 
LY 


public class combobox extends JApplet 


( 
private JComboBox jcombobox = new JComboBox () 5 


public void init () 
I 


Container contentpane = getContentPane0; 


Jcombobox.addiltea("Eisnerto 1%)7 
joonbobox.adiTtea|"Elenanto 2%); 
Jcanbaboxz.Aadditea("Elenento 3*)5 
joombobor.addltes "Elemento å"); 
Joonbobox. aidr tan | "Elemento 5%); 


El resultado se muestra en la figura 14.1, donde puede ver el cuadro 
combinado con su lista desplegable abierta, mostrando los cinco elementos. 
Cuando el usuario selecciona un elemento de esa lista y suelta el botón del 
ratón, el elemento queda como nuevo elemento seleccionado en el cuadro 
combinado y también aparece en el campo de texto. Este ejemplo se encuen- 
tra en el archivo combobox.java del CD que acompaña a este libro. Observe 
que, por defecto, el campo de texto en el cuadro combinado no es editable; 
mostraremos cómo cambiarlo en unas pocas páginas. 
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Figura 14.1. Creación de un cuadro combinado. 


Por tanto, ¡cómo recuperar elementos de un cuadro combinado? Debido a 
que únicamente se puede seleccionar al mismo tiempo un elemento de un 


cuadro combinado, puede obtener ese elemento con el método get-elected-temT 
que devuelve el mismo elemento (observe que el elemento es un objeto). 
También puede utilizar getSelectedIndex para determinar el índice del ele- 
mento seleccionado en curso en el cuadro en la lista del cuadro combinado, 
como sigue: 


String outstring = (String)jcombobox.getSelectedItemo 
int index = (String) jcombobox.getSelectedIndex0 


Para obtener un elemento en un índice específico, utilice el método 
getElementAt del modelo. También puede utilizar los métodos insertElementAt 
y removeElementAt del modelo para editar la lista. 

Observe que también puede responder a los eventos del cuadro combina- 
do. Lo examinaremos en el siguiente tema. 


Manejo de los eventos de selección del cuadro 
combinado 


El programador novato vuelve y dice, "Quiero cambiar el color de dibujo 
en mi nuevo programa tan pronto como el usuario seleccione un nuevo color 
de un cuadro combinado; ¿cómo puedo hacerlo?". "Es fácil", respondemos, 
"basta con hacer que el código responda a eventos de selección”. "Ajá", dice 
el PN. "Aquí tiene mi código, ¿puede arreglarlo?". 

Puede utilizar dos tipos de receptores con cuadros combinados: receptores 
de acción para manejar eventos de edición en el cuadro de texto y receptores 
de elementos para manejar selecciones de listas. Examinaremos las seleccio- 
nes de listas en este tema y los eventos de edición en el siguiente. 

Para manejar eventos de selección, basta con añadir un receptor de ele- 
mentos al cuadro combinado del ejemplo desarrollado en el tema previo: 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


<APPLET 
CODE = comboboxevents.class 
WIDTH = 300 
HEIGHT = 200 > 
</APPLET> 
“7 


public class comboboxevents extends JApplet implements ItemListener 


JComboBox jJcombobox = new JComboBox0; 
String outstring = “"; 
public void initoO 

I 


Container contentpane = getContentPane0; 


jcombobox.addItem("Elemento 1"); 
Jjcombobox .addItem("Elemento 2”); 
jcombobox.addlItem ("Elemento 3"); 
jcombobox.addItem ("Elemento 4"); 
jcombobox.addItem("Elemento 5"); 


Jessbobes. addiIrtemListenar {this} y 


Ahora añadimos el método itemStateChanged a este applet que necesita la 
interfaz ItemListener: 


public void itemStateChanged (1temEvent e) 
I 


1 
Este método recibe un objeto de la clase ItemEvent y puede determinar si 


el elemento correspondiente en la lista del cuadro combinado estaba seleccio- 
nando, utilizando el método getStateChange como sigue: 


public void itemStateChanged (1temEvent e) 
I 
if (e.getStateChange() == ItemEvent-SELECTED) 


Indicaremos si un elemento estaba seleccionado o deseleccionado en la 
barra de estado del applet como sigue: 


public void itemStateChanged (1temEvent e) 
I 


if(e.getStateChange0 == 1temEvent .SELECTED) 

outstring += "Seleccionado: "+ (String)e.getltemo; 
else 

outstring += "Deseleccionado: =" + (String)e.getltemo; 


sbowStatus(outstringi; 


[my] 
me] 
Ly 


El resultado de este código se muestra en la figura 14.2. Como puede ver 
en el pie del applet de la figura, el código informa cada vez que el usuario 
deselecciona un elemento y selecciona otro. Este programa es un éxito y se 
encuentra en el archivo comboboxevents.java del CD. 
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Figura 14.2. Trabajo con eventos de selección del cuadro combinado. 


Creación de cuadros combinados editables 


"Maldición", dice el programador novato, "no puedo hacer que el campo 
de texto de mi cuadro combinado funcione; parece que no puedo introducir 
ningún texto en él". Sonreímos y contestamos, "Eso es debido a que lo tiene 
como editable". "Ah", dice el PN. "¿Cómo puedo hacerlo?”. 

Para convertir el campo de texto en un cuadro combinado editable, utilice 
el método setEditable. Para manejar eventos de edición, utilice un receptor de 
acciones. 

Aquí tenemos un ejemplo donde hacemos el cuadro combinado editable y 
le añadimos un receptor de acción: 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


7E 
<APPLET 
CODE = comboboxedit.class 
WIDTH = 200 
HEIGHT = 200 > 
</APPLET> 
* 
/ 
public class comboboxedit extends JApplet implements ActionListener 
( 


private JComboBox jcombobox = new JComboBox (); 


public void hito 
( 


Container contentpane = getContentPane0; 


nb bobok- Add tar Elamārrit 


lo] (dd ter 


joombobos.gatiditor[).aidicriocsLlatener(cbla]|; 


Observe que no estamos añadiendo un receptor de acción al cuadro combi- 
nado directamente sino, más bien, al editor del cuadro combinado, que es un 
objeto que implementa la interfaz ComboBoxEditor. Obtenemos este objeto 
con el método getEditor. El editor es responsable de las acciones de edición 
en el campo de texto del cuadro combinado, y la tabla 4.5 muestra los 
métodos de ComboBoxEditor. 

En este ejemplo, mostramos el texto del elemento antes de que se haya 
editado y el texto después de que haya sido editado y el usuario pulse Intro. 
Para obtener el texto del elemento antes de su edición, puede utilizar el 
método getSelectedltem y para obtener el elemento después de su edición, 
puede utilizar el método getltem, como sigue: 


public void actionPerformed(ActionEvent e) 


{ 
String outString = (String) jcombobox.getSelectedItemo 


+ " se cambió a " + (String) jcombobox.getEditor0 .getlItemo ; 


ohowritatus (couestringl p 


La figura 14.3 muestra el resultado. Cuando el usuario edita un elemento 
en el campo de texto y pulsa Intro, el texto viejo y nuevo del cuadro combina- 
do aparecen en la barra de estado del applet, como muestra la figura. Este 
ejemplo se encuentra en el archivo comboboxedit.java del CD. 


Tabla 14.5. Métodos de la interfaz ComboBoxEditor 


Metodo Descripción 


void addActionListener(ActionListener 1) Añade un receptor de acciones. 


Component getEditorComponent() Devuelve el componente del edi- 
tor. 
Object getltem() Devuelve el elemento editado. 


void removeActionListener(ActionLis- Elimina al receptor de acciones. 
tener J) 


void selectAll() Solicita al editor el inicio de la 
edición y selecciona todo. 


void setltem(Objectanobject) Asigna el elemento que debería 


ser editado. 
a 


Elemento 1 se cambió a Elemento 15 


Figura 14.3. Edición del campo de texto de un cuadro combinado. 


Adición de imágenes a cuadros combinados 
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"Veamos", dice el programador novato, "jexiste alguna posibilidad de 
mostrar imágenes en un cuadro combinado?" "Claro", decimos, "basta con 
sentarse y examinarlo”. 

Puede añadir imágenes a cuadros combinados al igual que puede hacerlo 
con cuadros de lista. De hecho, cuando añade imágenes a los cuadros combi- 
nados, realmente añade imágenes a la parte de lista del cuadro combinado; 
por lo que el proceso es prácticamente igual que añadir imágenes a las listas. 

Aquí tenemos un ejemplo en el que creamos un nuevo modelo, newModel, 
y el renderizador de celdas, newRenderer, para un cuadro combinado. Aquí 
vemos cómo instalarlo en el cuadro combinado: 


import jJava.awt.*; 
import jJavax.swing.*; 
import java.awt.event.*; 


/ * 
<APPLET] 
CODE 
WIDTH 
HEIGH 


T 


</APPLI 
/ 


* 


ET 


comboimages.class 
400 


vV 


public class cornboimages extends JApplet 


I 


public void init (l 


( 


Container contentpane = getContentPane0; 
contentPane.setLayoutínew FlowLayoutoO) ; 


nemodel ne-del = new newModel() 5 
nemenderer newrenderer = new newRenderer0; 


JCdoBox jlist = new JComboBox (newmodel) ; 
jlíst.setRenderer (ne=enderer) ; 


contentFane.eddinew JSorolifaneijlist})} y 


Este nuevo modelo y renderizador almacenará y visualizará las imágenes 
en un cuadro combinado y la figura 14.4 muestra el resultado. Ahora, lo 
único que resta es crear el nuevo modelo y el nuevo renderizador y lo hare- 
mos en los dos temas siguientes. Este ejemplo se encuentra en el archivo 


comboimages.java del CD. 


Figura 14.4. Adición de imágenes a cuadros combinados. 


Creación de un modelo de cuadro combinado 


Crearemos un nuevo modelo de cuadro combinado en este tema para 
utilizarlo con el cuadro combinado del tema anterior (el que visualiza imáge- 
nes). Este nuevo modelo, que extiende la clase DefaultComboBoxModel, 
utilizará el método addElement para almacenar los elementos de datos en el 
modelo. 

Cada elemento se compone de una cadena de texto y un icono de imagen' 
como sigue: 


class newModel extends DefaultComboBoxModel 


I 
public newModel0 
I 
for(int loop—index = 0; loop—index <= 12; loop-index++) ( 
addElement (new Object [1 ("Elemento " + loop—index, 
new Imagelcon ("combo.jpg")1); 


Creación de un renderizador personalizado para 
el cuadro combinado 


En este tema, crearemos un renderizador que visualice imágenes en un" 
cuadro combinado (este renderizador se utiliza en el código de los dos temas 
anteriores). Para crear el renderizador de celdas para un cuadro combinado, 
basta extender la clase JLabel, que es la clase de cada elemento en un cuadro 
combinado, e implementar la interfaz ListCellRenderer. Para implementar 
esa interfaz, sobrescribimos el método getListCellRendererComponent utili- 
zando los métodos setText y setlcon de la clase JLabel para instalar el texto e 
imágenes en el cuadro combinado: 


class newRenderer extends JLabel implements ListCellRenderer 


{ 


public newRenderer0 


public Component getListCellRendererComponent ( 
JList jlist, Object obj, int index, boolean isselected, 
boolean focus) 


newModel model = (newModel)jlist.getModel (); 


setTexti (String) ((Objectrl) o0b3)[0]): 
setIcon ((Iconi ((Object[1)o0b3) [1]); 


return this; 
1 


El resultado se muestra en la figura 14.4, donde puede ver las imágenes 
visualizadas en un cuadro combinado. 


Creación de barras de progreso 


"Bien”, dice el programador novato, "es cierto que lleva tres horas el que 
mi programa ordene sus datos internos, pero ¿existe alguna razón para que 
los usuarios lo comprendan?" "Por supuesto", decimos, "a menos que le dé 
algún tipo de indicación visual de lo que sucede. ¿Qué tal si añadimos una 
barra de progreso a su programa?". "¡Claro! "dice el PN. "¿Quées una barra 
de progreso?" 

Un control de barra de progreso dibuja una barra coloreada y actualizada 
dentro de sí mismo para visualizar el progreso de alguna operación. Puede 
configurar los valores mínimo y máximo de la barra de progreso cuando 
llama al constructor JProgressBar, o puede utilizar los métodos setEMinimum 
y setMaximum. Puede actualizar repetidamente la barra de progreso llaman- 
do a su método setValue para indicar el estado progresivo de la operación. 
Aquí tenemos el diagrama de herencia para la clase JProgressBar: 
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Puede encontrar los campos de la clase JProgressBar mostrados en la tabla 
14.6 (observe que también hereda dos constantes de la clase SwingConstants 
que utilizamos para la orientación: HORIZONTAL y VERTICAL), sus cons- 
tructores se muestran en la tabla 14.7 y sus métodos se muestran en la tabla 
14.8. 


Tabla 14.6. Campos de la clase JProgressBar. 


Descripción 


protected ChangeEventchange- El evento de cambio. 
Event 


protected ChangeListenerchange- El receptor de cambio. 
Listener 


protected BoundedRangeModel El modelo de datos que contiene los 
model valoresde datos parala barra de progre- 
So. 


protected int orientation La orientación en que se visualiza la 
barra de progreso. 


protected boolean paintBorder Devuelve cierto si debe existir un borde 
alrededor de la barra de progreso. 


protected boolean paintstring Devuelve cierto si debe existir una 
etiqueta de cadena en la barra de 
progreso. 


protected String progressstring Cadena opcional que puede mostrarse 
en la barra de progreso. 


Tabla 14.7. Constructores de la clase JProgressBar. 


Constructor Descripción 


| JProgressBar() Construye una barra de progreso hori- 
zontal. 
JProgressBar(BoundedRange- Construye una barra de progreso hori- 
Model newModel) zontal (orientación predeterminada). 
JProgressBar(intorient) Construye una barra de progreso con 


la orientación indicada, que puede ser 
o bien JProgressBar. VERTICAL o 
JProgressBar.HORIZONTAL. 


JProgressBar(int min, int max) Construye una barra de progreso hori- 
zontal, que es la predeterminada. 


Constructor 


JProgressBar(int orient, int min, 
int max} 


Descripción 


Construye una barra de progreso utili- | 
zando la orientación y los valores mí- 
nimo y máximo indicados. 


Tabla 14.8. Métodos de la clase JProgressBar. 


Método 


(æ 
iñ 


void addChangeListener(Change- 
Listener 1) 


protected ChangeListener create 
ChangeListenerO 


AccessibleContext getAccessible- 
Contexto 


int getMaximum() 
int getMinimum() 
BoundedRangeModelgetModel() 


int getOrientation0 


double getPercentComplete() 


String getStringO 


ProgressBarll gatul 


String getUlClassID() 


int getValue() 


boolean isBorderPainted() 


boolean isStringPainted() 


protected void fireStateChanged0O Notifica a todos los receptores que re- 


Añade un receptor de cambios. 


Crea un receptor de cambios. 


gistraron interés para la notificación de 
este tipo de evento. 


Obtiene el contexto accesible asociado 
con este objeto JComponent. 


Obtiene el valor máximo del modelo. 
Obtiene el valor mínimo del modelo. 
Obtiene el modelo de datos. 


Devuelve JProgressBar.VERTICAL o 
JProgressBar.HORIZONTAL. 


Obtiene el porcentaje completado para 
la barra de progreso. 


Obtiene el valor en curso de la cadena 
de progreso. 


Obtiene el objeto apariencia que rende- 
riza este componente. 


Obtiene el nombre de laclase apariencia 
que renderiza este componente. 


Obtiene el valor actual del modelo. 


Devuelve cierto si la barra de progreso 
tiene un borde y falso en otro caso. 


Devuelve cierto si la cadena se va a 
dibujar en la barra de progreso. 


Método Descripción 


protected void paintBorder(Gra- Pinta el borde de la barra de progreso 
phics g) (siempre que la propiedad BorderPain- 
ted sea cierto). 


protected String paramString() Obtiene una representación de cadena 
del objeto JProgressBar. 


void removeChangeListener(Chan- Elimina un receptor de cambios del bo- 
geListener |) tón. 


void setBorderPainted(booleanb)  Asigna si la barra de progreso debería 
pintar su borde. 


void setMaximum(int n) Asigna el valor máximo del modelo a n. 

void setMinimum(int n) Asigna el valor mínimo del modelo a n. 

voidsetModel(BoundedF4angeMo- Asigna al modelo de datos utilizado por 

del newModel) el objeto JProgressBar. 

void setOrientation(int neworien-  Asigna la orientación de la barra de 

tation) progreso a neworientation. 

void setString(String S) Asigna el valor de la cadena de progre- 
so. 

void setStringPainted(booleanb)  Asignasilabarra de progreso renderiza 
una cadena. 

void setUl(ProgressBarUl ui) Asigna el objeto apariencia que rende- 
riza este componente. 

void setValue(int n) Asigna el valor actual del modelo a n. 

void updateUl() Llamada por la clase UlFactory para 


indicar que la apariencia ha cambiado. 


Existen diversas formas de visualizar las barras de progreso. Por ejemplo, 
puede hacerlas horizontales o verticales cuando llama al constructor de la 
clase o utilizar el método setorientation. También puede seleccionar el color 
de dibujo para la barra actual, visualizar la etiqueta dentro de la barra de 
progreso que indique el valor en curso, y más. El uso básico de todas las 
barras de progreso, no obstante, es el mismo sin importar la apariencia que 
tengan; asignamos un valor mínimo y máximo a la barra de progreso (los 
valores predeterminados son O y 100) y actualizamos su pantalla con el 
método setValue según convenga. Aquí tenemos unos pocos ejemplos que 
muestran algunas de las formas en que podemos mostrar las barras de progre- 
so: 


import java.awt.*; 
import Javax.swing.*: 
JE 
<APPLET 
CODE = progressbar.class 
WIDTH = 500 
HEIGHT = 200 > 
</APPLET> 
*/ 


public class progressbar extends JApplet 
I 


JProgressBar jprogressbarl, jprogressbar2, jprogressbar3, 


Jprogressbar4, jprogressbar5, jprogressbar6; 


public void initO 
I 


Container contentpane = getContentPane0; 


Jjprogressbarl = new JProgressBaro; 
jprogressbarl.setValue (50); 
contentPane.add (jprogressbarl); 


Jprogressbar2 = new JProgressBar (); 
jprogressbar2.-etMinimum(100); 
jprogressbar2.-“etMaximum (200); 
jprogressbar2.setValue (180); 
jprogressbar2.setForegroundíColor.red); 
contentPane.add (jprogressbar2); 


jprogressbar3 = new JProgressBar (); 
jprogressbar3.setOrientation(JProgressBar .VeRTICAL) ; 
jprogressbar3.setForegroundíColor.blue); 
jprogressbar3.setValue (50); 
jprogressbar3.-etStringPainted (true); 

jprogressbar3.setBorder (BorderFactory.createRaisedBevelBorder-)); 
contentPane.add (jprogressbar3); 


jprogressbar4 = new JProgressBaro; 
jprogressbar4.setOrientation (JProgreasBar .VeRTICAL); 
jprogressbar4.setForeground (Color.red) ; 
jprogressbar4.setValue (80); 
jprogressbar4.-etStringPainted (true); 
jprogressbar4.-“+-etBorderPainted (false): 
contentPane.add (jprogressbar4); 


jprogressbar5 = new JProgressBaro; 
jprogressbar5.-etOrientation(JProgreseBa); 
jprogressbar5.-etstringPainted (true); 
jprogressbar5.-etString("-Holdesde Swingl"); 
j-rogressbar5.setValue (90); 

contentPane.add (jprogressbar5); 


El resultado de este código se muestra en la figura 14.5, donde puede ver 
varias barras de progreso visualizadas de formas distintas. Aquí tenemos 
muchas posibilidades (observe, en concreto, que puede añadir una etiqueta a 
la barra de progreso para indicar su configuración actual y puede personalizar 
el borde). Este ejemplo se encuentra el en archivo progressbar.java del CD. 

Por otro lado, las barras de progreso estáticas, como las que muestra la 
figura 14.5, no tienen mucha utilidad ya que no hacen nada. Para ver cómo 
actualizar una barra de progreso, examine el tema siguiente. 
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Figura 14.5. Visualización de barras de progreso. 


Actualización de barras de progreso 


El programador novato dice, "Vaya, he puesto barras de progreso en mí 
programa, pero no hacen nada; ¿qué está mal?" "Bien", respondemos, "eso se 
debe a que tiene que llamar al método setValue para actualizarlas". "Ajá", 
dice el PN. 

Después de la creación y visualización de una barra de color de progreso, 
es cuenta del programador actualizarla con el método setvalue. Normalmente 
lo haremos dividiendo la tarea que consuma tiempo en partes y actualizare- 
mos la barra de progreso a medida que se complete cada parte. 

Aquí tenemos un ejemplo (progressbarupdate.java en el CD) que incrementa 
una barra de progreso cada vez que se pulsa un botón: 

import java.awt.*; 


import javax.swing.*; 
import java.awt.event.*; 


CAPPLET 
CODE = progressbarupdate.class 
WIDTH = 400 
HEIGHT = 200 > 
c/APPLET> 
s7 


public class progressbarupdate extends JApplet 
( 


JProgressBar jprogressbar = new JProgressBaro0; 
JButton jbutton = new JButtoní"lncrementar la barra de progreso"); 


public void init() 


I 
Container contentpane = getContentPane0; 
entent Pane. setLayott {new FlowLayout iji i 


sobar. .setstriogreinted |trus 


jbutton.addActionListener (new ActionListenerO ( 
«“ublicvoid actionPerformed (ActionEvent e) 


{ 
jprogressbar.setValue (jprogressbar.getValue () + 10); 
1 


>); 


El resultado se muestran en la figura 14.6. Observe que puede actualizar la 
barra de progreso solamente haciendo clic sobre el botón. Normalmente, por 
supuesto, su código actualizará la barra de progreso automáticamente, debido 
a que las barras de progreso se utilizan para indicar al usuario el progreso de 
las operaciones que consumen tiempo. 


Figura 14.6. Actualización de una barra de progreso. 


Manejo de los eventos de barras de progreso 


Los eventos de barras de progreso ocurren cada vez que el valor de la barra 
de progreso cambia, y podemos trabajar con receptores de cambios para 
capturar esos eventos. Aquí tenemos un ejemplo (progressbarevents.java en 
el CD) que permite al usuario actualizar la barra de progreso con un botón. 
Captura los eventos a medida que suceden. Informamos del nuevo valor de la 
barra de progreso cada vez que cambia, junto con sus valores mínimo y 
máximo, como se muestra a continuación: 


import jJjava.awt.*; 
import jJavax.swing.*; 
import java.awt.event.*; 
import Javax.swing.event.*; 
Je 
<APPLET 
CODE = progressbarevents.class 


WIDTH = 400 
HEIGHT = 200 > 
</APPLET> 
E 


public class progressbarevents extends JApplet 
I 
JProgressBar jJprogressbar = new JProgressBar (); 
JButton jbutton = new JButton("lncrementar la barra de progreso"); 


public void inití) 
I 


Container contentpane = getContentPane0; 


jbutton.addActionListener (new ActionListeneroO ( 
public void actionPerformed (ActionEvent e) 
{ 
jprogressbar.setValue (jprogressbar.getValue0 + 10); 
1 
1); 


jprogressbar .addChange~istener (newChangeListenero ( 
public void statechanged (ChangeEvent e) 


1 
showStat~s (~MÍnimde la barra de progreso: Ti 


jprogressbar.getMinimum() + 


" máximo: " + jprogressbar.getMaxi- () + 
= yalor: " + jprogreesbar.getValue ()); 


1)3 
1 


El resultado de éste código se muestra la figura 14.7. Como vemos, cada 
vez que el usuario actualiza la barra de progreso, su nuevo valor aparece en la 
barra de estado del applet. Este ejemplo es un éxito y puede encontrarlo en el 
archivo progressbarevents.java del CD. 


pesega lara 


de Pana 


Figura 14.7. Manejo de eventos de barras de progreso. 


Creación de ayudas de herramientas 


"Bien", dice el especialista de soporte de productos, "no parece que nadie 
lea nunca los manuales. ¿Existe alguna forma de hacer que nuestros progra- 
mas sean autoexplicativos?" "Bien", decimos, "podría reducir todo a una 
serie de animaciones”. "Mm", dice el ESP pensativo. "Es una broma", con- 
testamos rápidamente. "Añadiremos ayudas de herramientas a los controles 
del programa". 

Las ayudas de herramientas son ventanas pequeñas que aparecen cuando 
el usuario deja parado el ratón sobre un componente. Visualizan algún texto 
que explica el propósito del control. Por ejemplo, la ayuda de herramientas 
del botón Cortar podría leer "Corta el texto seleccionado". Las ayudas de 
herramientas están soportadas por la clase JT'oolTip de la Swing y aquí 
tenemos el diagrama de herencia de clase: 
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La tabla 14.9 muestra el constructor de la clase JToolTip y la tabla 14.10 
muestra sus métodos. 


Tabla 14.9. El constructor de la clase JTooITip. 


Constructor 


Descripción 


| JToolTip() Construye una ayuda de herramien- 
tas. 


Tabla 14.10. Métodos de la clase JTooITip. 


Método Descripción 


AccessibleContext getAccessible- Obtiene el contexto accesible. 

Contexto 

JComponent getComponent() Obtiene el elemento al que se aplica 
la ayuda de herramientas. 

String getTipText0 Obtiene el texto que se muestra en 
la ayuda de herramientas. 

| ToolTipUl getii Obtiene el objeto apariencia que 
renderiza este componente. 

String getUlClassID() Obtiene el nombre de la clase apa- 
riencia que renderiza este compo- 
nente. 

protected String paramStringO Obtiene una representación de ca- 


dena de este objeto JToolTip. 


void setComponent(JComponentc)  Asignaelcomponente que describe | 
esta ayuda de herramientas. 


void setTipText(StringtipText) Asigna al texto mostrado cuando 
aparece la ayuda de herramientas. 


void updateUl() Llamada por la clase UlFactory 
cuando cambia la apariencia. 


Muchos componentes ya tienen un método setToolTipText que puede 
utilizar para añadir una ayuda de herramientas. Aquí tenemos un ejemplo en 
el que añadimos una ayuda de herramientas a un botón: 


. A * 

import java.awt. ; 
import javax.swing.*; 
import java.awt.event.*; 


public class tooltip extends JApplet ( 
JButton button = new JButton ("Haz clic aquí"); 
JTextField text = new JTextField(20); 


public void init () 
t 


Container contentpane = getContentPane0; 


dal Lal 


button.setToolTipText ("Estoes un botón."); 


public void actionPerformed(ActionEvent event) ( 
text . setText ("¡Hola desde Swing!") ; 


1); 
1 
Es tan sencillo como añadir una ayuda de herramientas a la mayoría de los 


componentes. El resultado se muestra en la figura 14.8, donde puede ver la 


ayuda de herramientas con su texto explicativo. Este ejemplo se encuentra en 
el archivo tooltip.¡ava del CD. 


Erronea olga da 


Figura 14.8. Uso de ayudas de herramientas. 


Creación de separadores 


El programador novato dice, "El gran jefe me ha dicho que hay demasia- 
dos campos de texto en mi programa y debería dividirlos en grupos". "Puede 
hacerlo de diversas formas senc,illas", respondemos, "como añadir campos de 
texto a los paneles y dar a los paneles varios colores de fondo. Puede incluso 
utilizar separadores. Para empezar, ¿Cuántos campos de texto existen en su 
programa?" "Cerca de 2.413",dice el PN. "Ojo", decimos. 

Los separadores son líneas verticales u horizontales y normalmente apare- 
cen en los menús para separar elementos de menú en grupos lógicos, pero 
también pueden utilizarse para separar componentes en una distribución. 
Quedan soportados por la clase JSeparator en la Swing, y aquí tenemos el 
diagrama de herencia de clase: 


La tabla 14.11 muestra los constructores de la clase JSeparator y la tabla'i 
14.12 muestra sus métodos. 


Tabla 14.11. Constructores de la clase JSeparator. 


Constructor Descripción 

JSeparatorO Crea un nuevoseparador horizontal. 

JSeparator(intorientation) Crea un nuevo separador con la 
orientación horizontal o vertical 
indicada. 


Tabla 14.12. Métodos de la clase JSeparator. 


Descripción 
AccessibleContext getAccessible- Obtiene el contexto accesible. 
Contexto 
int getOrientation() Obtiene la orientación de este sepa- 
rador. 


Método Descripción 


SeparatorUl get) Obtiene el objeto apariencia que ren- 
deriza este componente. 

String getUlClassID() Obtiene el nombre de la clase apa- 
riencia que renderiza este compo- 
nente. 

boolean isFocusTraversable() Indica si este componente puede re- 
cibir el foco. 

protected String paramStringO Obtiene una representación de ca- 


dena de este objeto JSeparator. 
void setOrientation(int orientation) Asigna la orientación del separador. 


void setUl(SeparatorU1 ui) Asigna el objeto apariencia que ren- | 
deriza este componente. 


void updateUl() Llamada por la clase UlFactory 
cuando cambia la apariencia. 


Vamos a examinar un ejemplo. Aquí, situamos un separador entre los 
campos de texto en una distribución de flujo. Para hacer visible el separador, 
tenemos que hacer algo más que añadirlo a la distribución; también debemos 
proporcionar un tamaño preferente utilizando el método setPreferredSize. La 
forma normal de hacerlo es utilizar el método getPreferredSize del separador 
para obtener el ancho actual del separador y después pasarlo con el nuevo 
tamaño que queramos en el método setPreferredSize. Los métodos 
setPreferredSize y setPreferredSize trabajan con objetos de la clase Dimension 
de la AWT, que tiene los campos: width y height. Aquí tenemos la forma de 
crear un nuevo separador y obtener sus dimensiones: 


import Java.awt.*; 
import jJavax.swing.*; 


+ 
<APPLET 
CODE = separator.class 
WIDTH = 400 
HEIGHT = 200 > 
</APPLET> 
7 


public class separator extends JApplet 

{ 
JSeparator jseparator = new ~~eparator (~Separator.VERTICAL)i 
Dimension dimension = jseparator.get-referredSiZe-); 


Ahora podemos poner el separador entre los campos de texto, como hace- 
mos aquí, dándole una altura de cien puntos: 


public class separator extends JApplet 


{ 
JSeparator jseparator = new JSeparator (JSeparator.VERT1CAL); 


Dimension dimension = jseparator.getPreferredSize0; 


public void initoO 


{ 


Container contentpane = getContentPane0; 
contentFans: setLayout [ner Fiolayoue i ii; 


contentPane.add (new STextField("iH0la desde Swingl")); 
contentPane.add (jseparator); 
contentPane.add (new JTextField ("iHola desde Swingl")); 


jesparstor.setPreferredilsa] ss Disaralos[dimension.wldtE, 100117 


El resultado de este código (separator.java en el CD) se muestra en la 
figura 14.9. Como muestra la figura, el separador aparece entre los dos 
campos de texto. 

A pesar de todo, tenemos un problema, ¿qué sucede si cambia el tamañol 
del applet? En ese caso, podríamos querer cambiar el tamaño del separador 
para que se ajuste. Podemos hacerlo procesando los eventos de cambio de 
tamaño; consulte el siguiente tema para ver los detalles. 


[El Sip Weerci reparado chri 


[Hoia a sde Swingl 


Figura 14.9. Creación de un separador. 


Cambio de tamaño automático de separadores 


Para cambiar el tamaño de un separador, podemos capturar los eventos de 
cambio de tamaño del componente utilizando la interfaz ComponentListener, 
que maneja los eventos de cambio de tamaño para componentes, incluyendo 
applet y ventanas. Los métodos de esta interfaz se muestran en la tabla 14.13. 


Tabla 14.13. Métodos de la interfaz ComponentListener. 


Método Hace ésto 


void componentHidden(Component- Llamado cuando se hace invisible el 
Event e) componente. 


void componentMoved(Component- Llamado cuando la posición del 
Event e) componente cambia. 


voidcomponentResized(Component- Llamado cuando el tamaño del com- 
Event e) ponente cambia. 


void componentShown(Component- Llamado cuando se hace visible el 
Event e) componente. 


Por ejemplo, cuando cambia el tamaño de su applet, puede cambiar el 
tamaño del separador asignando el que desee. Aquí tenemos un ejemplo en el 
que creamos un separador entre los campos de texto, que va desde la parte 
superior de la ventana del área de cliente del applet hasta la parte inferior y 
mantiene esa extensión incluso cuando cambia de tamaño el applet. Aquí 
tenemos el código: observe el código de cambio de tamaño en los métodos 
componentshown (para visualizar por primera vez el separador) y 
componentkResized: 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


Je 
<APPLET 
CODE = separatorevents.class 
WIDTH = 400 
HEIGHT = 200 > 
</APPLET> 
* 
/ 
publicclass separatorevents extendsJApplet implements ComponentListener 


{ 


JSeparator jseparator = new ~~eparator (JSeparator.VERTICAL); 


Dimension dimension = jseparator.getPreferredSize0; 


public void init0 
I 


Container contentpane = getContentPane0; 
ntPane.setLayout |new F 


contentPane.add (new JTextField ("iHola desde Swing!")); 
contentPane.add (jseparator); 
contentPane.add (new JTextField ("iHoladesde Swing!")); 


public void componentShown (ComponentEvent e) 
{ 
jseparator .setPreferredSize (new ~imension (dimension.width, 
gatāizs |} -baight)] ji 
Jeapasrator.reralidatal i; 


public void componentResized (ComponentEvent e) 
{ 
jseparator.set~referredSize (newDimension (dimension.width, 
getSize0-height)); 
jseparator.revalidate0; 


public void componentMoved (ComponentEvent e) (1 
public void componentHidden (ComponentEvent e) O 
1 


El resultado de este código se muestra en la figura 14.10. Como puede ver7 
el separador se extiende desde la parte superior del área de cliente del applet 
hasta la parte inferior y cambiará de tamaño automáticamente junto con el 
applet. Este ejemplo se encuentra en el archivo separatorevents.java del CD. 


Lippi claried 


Figura 14.10. Creación de un separador que cambia de tamaño automáticamente. 
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Creación de un selector de color 


"Ahora tenemos un problema real", dice el programador novato. "Quiero 
permitir a los usuarios la selección de un color de dibujo para mi nuevo 
programa, SuperDuperArtisticPro,pero no puedo pedirles que introduzcan 
los nuevos valores de color”. "¿Por qué no utiliza un selector de color?", 
preguntamos. "¡Buena idea!", dice el PN. "Escriba el código y yo lo miro". 

Podemos permitir al usuario seleccionar un color con la clase JColorChooser 
de la Swing, que es un cuadro de diálogo ya creado que presenta al usuario 
diversas formas de seleccionar colores. Aquí tenemos el diagrama de heren- 
cia de la clase JColorChooser: 


java. lang. 0bject 


Puede encontrar los campos de la clase JColorChooser en la tabla 
14.14, la tabla 14.15 muestra sus constructores y la tabla 14.16 muestra sus 
métodos. 


Tabla 14.14. Campos de la clase JColorChooser. 


Campo Descripción 


protected AccessibleContextaccessi- El contexto accesible. 

blecontext 

static String CHOOSER-PANELS- El nombre de la propiedad de lama- 
PROPERTY triz del panel de selector. 

static String PREVIEW-PANEL- El nombre la propiedad del panel de | 
PROPERTY vista previa. 

static String SELECTION-MODEL-  Elnombredelapropiedaddel modelo 
PROPERTY de selección. 


Tabla 14.15. Constructores de la clase JColorChooser 


Constructor Descripción 


| JColorShooser() Construye un panel selector de color. 


ma 


Constructor 


Descripción 


JColorChooser(Color initialcolor) 


JColorChooser(ColorSelectionModel 


Construye un panel selectorde color 
con el color inicial indicado. 


Construye un panel selectorde color 


model) con el modelo de selección de color 
indicado. 
Tabla 14.16. Métodos de la clase JColorChooser. 
Método Descripción 


void addChooserPanel(AbstractCo- 
lorChooserPanelpanel) 


static JDialog createDialog(Compo- 
nent c, String title, boolean modal, 


JColorChooser chooserpane, Action- 


Listener oklistener, ActionListener 
cancellistener) 


AccessibleContext getAccessible- 
Contexto 


AbstraciColorChooserPanel[] get- 
ChooserPanels() 

Color getColor() 
JComponentgetPreviewPanel() 
ColorSelectionModel getselection- 


Model() 


ColorEhooseril getii) 


String getUlClassID() 


protected String paramStringO 


Aiíade un panel selector de color. | 


Construye y devuelve un nuevo diá- | 
logo con el colory indicado por else- 
lector de color con los botones 
Aceptar, Cancelar y Reiniciar. 


Obtiene el contexto accesible. 


Obtiene los paneles de color indi- 
cados. 


Obtiene el valor actual del color a 
partir del selector de color. 


Obtiene el panel de vista previa que 
muestra un color seleccionado. 


Obtiene el modelo de datos que ma- 
neja selecciones de color. 


Obtiene el objeto aparienciaqueren- 
deriza este componente. 


Obtiene el nombre de la clase apa- 
riencia que renderiza este compo- 
nente. 


Obtiene una representación de ca- 
denade este objetoJColorChooser. 


AbstractColorChooserPanelremove- Elimina el panel de color indicado. 


ChooserPanel(AbstraciColorChooser 


Panel panel) 


Método Descripción 


void setChooserPanels(AbstractColor- Especifica los paneles de color uti- 
ChooserPanel[] panels) lizados para seleccionar un valor de 
| color. 


void setColor(Color color) Asigna al color actual de selector de 
color el color indicado. 


void setColor(int c) Asigna al color actual del selector 
de color el color indicado. 


void setColor(int r, int g, int b) Asigna al color actual del sector de 
color al color RGB indicado. 


void setPreviewPanel(JComponent  Asignaelpanelde vista previa actual. 
preview) 


void setSelectionModel(ColorSelec-  Asigna el modelo que contiene el 


tionMode1 newModel) color seleccionado. 
void setUl(ColorChooserUl ui) Asigna al objeto apariencia que ren- 
deriza este componente. 


static Color showDialog(Component- Muestra el cuadro de diálogo de se- 
component, String title, Color initial- lección de color modal. 
Color) 


void updateUl() Llamada por la clase UlManager 
cuando la apariencia ha cambiado. 


Es sencillo utilizar un sector de color; lo único que tenemos que hacer es 
mostrarlo con el método showDialog y después pasar a este método un objeto 
padre, un título y un color predeterminado. Este método devuelve el color 
seleccionado por el usuario como un objeto Color (o el color predeterminado 
si el usuario no realizó selección alguna). 

Vamos a examinar un ejemplo en el que situamos un botón en un panel y 
permitimos al usuario visualizar el selector de color cuando haga clic sobre el 
botón. Una vez que el usuario seleccione un color, el código cambia el fondo 
del panel a ese color. Aquí tenemos el código: 

import java.awt.*; 


import javax.swing.*; 
import java.awt.event.*; 


<A PPLET 


CODE = colorchooser.class 
WIDTH = 200 
HEIGHT = 200 > 
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APFLET= 


public class colorchooser extends JApplet implements ActionListener 


{ 


JPanel jpanel = new JPanelO; 
JButton jbutton; 


public void init () 


jbutton = new JButton ("Hagaclic aquí para cambiar los colores."); 
jbutton.addActionListener (this); 
jpanel.add (jbutton1; 


garContent Pañe |) . add(jpsnel y Bborderiafóút., CENTER] 


public void actionPerformed (ActionEvent e) 


{ 


Color color = JColorChooser.showDialog(colorchooser.this, 
"Seleccione un nuevo color...", Color .white); 


jpanel.setRiackground icolori; 


Como puede ver, es sencillo utilizar un selector de color; éste apareceen í 
figura 14.11. Cuando el usuario selecciona un color en el selector, el nuevo 
color aparece en el panel del applet, como se muestra en la figura 14.12. Este 
ejemplo (colorchooser.java en el CD) es un éxito. 


bampi Tad Surge To 


Figura 14.11. Uso de un selector de color. 


El Apple Viera calctnnees cipia Mi= ES 
A 


Haga clic aquí para cambiar los colores. 


Figura 14.12. Cambio del color de un panel a un color seleccionado. 


Creación de selectores de archivos 


"Ajá", dice el programador novato, "necesito obtener el nombre de un 
archivo de usuario; ¿existe alguna forma rápida de hacerlo?" "Claro", deci- 
mos, "un campo de texto". "Bien", dice el PN, "quiero permitir que el usuario 
explore el disco para obtener el archivo correcto si fuera necesario". "Ah", 
decimos, "entonces desea un selector de archivos”. 

Los selectores de archivos son cuadros de diálogo que permiten al usuario 
especificar el nombre y vía de acceso de un archivo, permitiéndole explorar 
el espacio de disco si es necesario. Los selectores de archivos quedan sopor- 
tados por la clase JFileChooser. Aquí tenemos el diagrama de herencia para 
esta clase: 


La tabla 14.17 muestra los campos de la clase JFileChooser, la tabla 14.18 
sus constructores y la tabla 14.19 sus métodos. 
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Tabla 14.17. Campos de la clase JFileChooser. 


Campo 


protected AccessibleContext accessible- 
Context 


static String ACCESSORY-CHANGED- 
PROPERTY 


static String APPROVE-BUTTON-MNE- 
MONIC-CHANGED-PROPERTY 


static String APPROVE-BUTTON-TEXT- 
CHANGED-PROPERTY 


static String APPROVE-BUTTON-TOOL 
—TIP-TEXT-CHANGED-PROPERTY 


static int APPROVE-OPTION 


static String APPROVE-SELECTION 
static int CANCEL-OPTION 
static String CANCEL-SELECTION 


static String CHOOSABLE-FILE-FILTER- 
CHANGED-PROPERTY 


static int CUSTOM-DIALOG 


static String DIALOG-TITLE-CHANGED- 
PROPERTY 


static String DIALOG-TYPE-CHANGED- 
PROPERTY 


Descripción 


El contexto accesible. 


Indica que un componente 
accesoriodiferenteestáen uso. 


Indica un cambio enel mnemó- 
nico para el botón de Aceptar. 


Indica un cambio en el texto 
del botón AceptarfSilAprobar. 


Indica un cambio en el texto 
de la ayuda de herramientas 
paraelbotón AceptarfSilApro- 
bar. 


El valor de retorno si se se- 
lecciona el botón Aceptar/Si/ 
Aprobar. 


Instrucción para probar la se- 
lección actual. 


El valor de retorno si se- 
lecciona el botón Cancelar. 


Instrucción para cancelar la 
selección actual. 


Indica un cambio en la lista de 
títulos de archivo predeter- 
minados entre los que puede 
seleccionar el usuario. 


Valor de tipo indicando que el 
selectorde activos soportauna 
operación archivo específica- 
da por el desarrollador. 


Indica un cambio en el título 
del cuadro de diálogo. 


Indica un cambio en el tipo de 
archivos mostrados (única- 
mente archivos, sólo directo- 
rios o tanto archivos como 
directorios). 


static int DIRECTORIES-ONLY 

static String DIRECTORY-CHANGED- 
PROPERTY 

static int ERROR-OPTION 

static String FILE-FILTER-CHANGED- 
PROPERTY 

static String FILE-HIDING-CHANGED- 
PROPERTY 


static String FILE-SELECTION-MODE- 
CHANGED-PROPERTY 


static String FILE-SYSTEM-VIEW-CHAN- 
GED-PROPERTY 


static String FILE-VIEW-CHANGED- 
PROPERTY 


static int FILES-AND-DIRECTORIES 
static int FILES- ONLY 


static String MULTI-SELECTION-ENA- 


| BLED-CHANGED-PROPERTY 


static int OPEN-DIALOG 


static int SAVE-DIALOG 


static String SELECTED-FILE-CHAN- 
GED-PROPERTY 


Descripción 


Instrucciónpara visualizar úni- 
camente directorios. 


Indica un cambio de directorio. 


El valor de retorno si ocurre un 
error. 


El usuario cambia el tipo de 
archivos a mostrar. 


Indica un cambio en la propie- 
dad "Mostrar archivos ocul- 
tos”. 


Indica un cambioen laclasede 
selección (simple, múltiple y 
así sucesivamente). 


Indica que se está utilizando 
un objeto diferente para encon- 
trar los archivos disponibles 
en el sistema. 


Indica que se utiliza un objeto 
distinto para recuperar infor- 
mación de los archivos. 


Instrucciónpara visualizartan- 
to archivos como directorios. 


Instrucciónpara visualizarúni- 
camente archivos. 


Permite selección múltiple de 
archivos. 


Indica que el selector de archi- 
vos soporta una operación de 
apertura de archivos. 


Indica que el selector de ar- 
chivos soporta la operación 
para guardar archivos. 


Indica un cambio en la se- 
lección única de archivos del 
usuario. 


Campo 


| static String SELECTED FILES _CHAN- 
GED-PROPERTY 


Descripción 


Indica un cambio en la se- 
lección múltiple de archivos 
del usuario. 


Tabla 14.18. Constructores de la clase JFileChooser. 


Constructor Descripción 


JFileChooser() 


JFileChooser(File currentDirectory) 


JFileChooser(File currentDirectory, File- 
SystemView fsv) 


JFileChooser(FileSystemView fsv) 


JFileChooser(StringcurrentDirectoryPath) 


JFileChooser(String currentDirectoryPath, 
FileSystemView fsv) 


Construye un objeto JFile- 
Chooser. 


Construye un objeto JFile- 
Chooser utilizando un archivo 
dado como vía de acceso. 


Construye un objeto JFile- 
Chooserutilizandoel directorio 
actual dado y la vista del 
sistema archivos. 


Construye un objeto JFile- 
Chooser utilizando la vista del 
sistema archivos dada. 


Construye un objeto JFile- 
Chooser utilizando la vía de 
acceso dada. 


Construye un objeto JFile- 

Chooserutilizandoel directorio 
actual en curso como vía de 
acceso y la vista del sistema 
archivos. 


Tabla 14.19. Métodos de la clase JFileChooser. 


Metodo 


Descripción 


boolean accept(File f) 
void addActionListener(ActionListener 7) 


void addChoosableFileFilter(FileFilterfilter) 


Devuelve cierto si el archivo 
deber mostrarse. 


Añade un receptor de accio- 
nes. 


Añade un filtro a la lista de 
filtros de archivo selecciona- 
bles. 


Método 


void approveSelection() 


void cancelSelection() 


void changeToParentDirectory() 
void ensureFilelsVisible(File f) 


protected void fireActionPerftormed(String 
command) 


FileFilter getAcceptAllFileFilter() 


AccessibleContext getAccessibleContext() 


JComponent getAccessory() 
int getApproveButtonMnemonic() 


String getApproveButtonText() 


String getApproveButtonToolTipText() 


FileFilter[] getChoosableFileFilters() 


File getCurrentDirectory() 
String getDescription(File f) 


Descripción 


Llamado por la IU cuando el 
usuario hace clic sobre los 
botones Guardar o Abrir. 


Llamada por la IU cuando el 
usuario hace clic sobre el botón 
Cancelar. 


Asigna el padre del directorio 
actual. 


Asegura que el campo indicado 
es visible. 


Notifica atodos los receptores 
que han registrado interés por 
la notificación de este tipo de 
evento. 


Obtiene el filtro archivos 
AcceptAll. 


Obtiene el contexto accesible 
asociadocon este objeto JFile- 
Chooser. 


Obtiene el componente acce- 
sorio. 


Obtiene el mnemónico del 
botón Aprobar. 


Obtiene el texto usado en el 
botónaprobaren FileChooser- 
Ul. 


Obtiene el texto de la ayuda 
de herramientas utilizada en 
el botón Aprobar. 


Obtiene la lista de filtros de 
archivo seleccionados por el 
usuario. 


Devuelve el directorio actual. 


Obtiene la descripción de ar- 
chivo. 
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Método Descripción 


String getDialogTitle() 


int getDialogType() 

FileFilter getFileFilter() 

int getFileSelectionMode() 

| FileSystemView getFileSystemView() 
FileView getFileView() 


Icon getlcon(File f) 


String getName(File f) 
File getSelectedFile() 
File[] getSelectedFiles() 


String getTypeDescription(File f) 
FileChooserUl getUl() 


| String getUlClassID() 


boolean isDirectorySelectionEnabled() 


boolean isFileHidingEnabled() 


Obtiene la cadena que va en | 
la barra de título del selector 
de archivos. 


Obtiene el tipo de este cuadro 
de diálogo. 


Obtiene el filtro de archivo 
seleccionado en curso. 


Obtiene el modo de selección 
de archivos actual. 


Obtiene la vista del sistema 
archivos. 


Obtiene la vista del archivo 
actual. 


Obtiene el icono para este ar- 
chivo otipo de archivo, depen- 
diendo del sistema. 


Obtiene el nombre de archivo. 
Obtiene elarchivo seleccionado. 


Obtiene unalista de los activos 
seleccionados si el selector 
de archivos permite la se- 
lección múltiple. 


Obtiene el tipo de archivo. 


Obtiene el objeto lUque imple- 
menta la apariencia de este 
componente. 


Obtiene unacadenaqueespe- 
cifica el nombre de la clase de 
apariencia que renderiza este 
componente. 


Un método conveniente que 
determina si los directorios se 
pueden seleccionar. 


Devuelve cierto si los activos 
ocultos no se muestran en el 
selector de archivos. 


Método Descripción 


boolean isFileSelectionEnabled() Un método conveniente que 
determina si los archivos son 
seleccionables basado en el 
modo de selección de archivo 
actual. 


boolean isMultiSelectionEnablea() Devuelve cierto si se pueden 
seleccionar múltiples archivos. 


boolean isTraversable(File f) Devuelve cierto si el archivo 
(directorio) se puede visitar. 


protected String paramStringO Obtieneunarepresentaciónde 
| cadena de este objeto JFile- 
Chooser. 


void removeActionListener(ActionListener1) Elimina un receptor de accio- 
nes del botón. 


boolean removeChoosableFileFilter(File- Elimina un filtro a partir de la 
lisFilter f) lista de filtros de archivos 
seleccionables. 


void rescanCurrentDirectory() Explorar de nuevo la lista de 
archivos a partir del directorio 
actual. 

void resetChoosableFileFilters() Reinicia el filtro de archivo 
seleccionado de la lista a su 
estado inicial. 

void setAccessory(JComponentnew- Asigna un componente acce- 

Accessory) sorio. 

void setApproveButtonMnemonic(char Asignael mnemónicodel botón 

mnemonic) Aprobar utilizando un carácter. 

void setApproveButtonMnemonic(int Asigna mnemónico del botón 

mnemonic) Aprobar utilizando un código 


de teclado numérico. 


void setApproveButtonText(String approve- Asigna el texto utilizado en el 
| ButtonText) botón Aprobar. 


void setApproveButtonToolTipText(String Asigna al texto de la ayuda de 
toolTipText) herramientas utilizada en el | 
botón Aprobar. 


void setCurrentDirectory(Filedir) Asigna el directorio actual. 


Metodo 


void setDialogTitle(StringdialogTitle) 


void setDialogType(int dialogType) 


void setFileFilter(FileFilterfilter) 


void setFileHidingEnabled(booleanb) 


void setFileSelectionMode(int mode) 


void setFileSystemView(FileSystemViewfsv) 


void setFileView(FileView fileview) 


void setMultiSelectionEnabled(boolean b) 


void setSelectedFile(File selectedFile) 
void setSelectedFiles(File[] selectedFiles) 


protected void setup(FileSystemView view) 


int showDialog(Component parent, String 
approveButtonText) 


Descripción 


Asigna la cadena que va en la 
barra de título de la ventana 
del selector de archivos. 


Asigna el tipo de este cuadro 
de diálogo. 


Asigna el filtro de archivos 
actual. 


Asigna la ocultación de archi- 
VOS. 


Asigna el selector de archivos 
que permite al usuario se- 
leccionar únicamente archi- 
vos, únicamente directorios o 
ambos. 


Asigna la vista del sistema 
archivos que utiliza un objeto 
JFileChooser. 


Asigna la vista de archivos 
utilizada para obtener infor- 
mación de la lU,como elicono 
que representará el archivo o 
la descripción del tipo de un 
archivo. 


Configura el selector de archi- 
vos para que pueda realizar 
selección múltiple. 


Asigna el archivoseleccionado. 


Asigna la lista de archivos se- 
leccionados si el selector de 
archivosestá configuradopara 
permitir selección múltiple. 


Realiza la configuración e jni- 
cialización del constructor. 


Visualizaun cuadro de diálogo 
de selector de archivos perso- 
nalizado con un botón Aprobar 
personalizado. 


Descripción 


int showOpenDialog(Component parent) Visualiza un cuadro de diálogo 
de selección de archivos "Abrir 
archivo". 


int showSaveDialog(Componentparent) Visualiza un cuadrodediálogo 
deselectorde archivos "Guar- 
dar archivo". 


void update Ul() Llamada por la clase U IFactory 
cuando cambia la apariencia. 


Puede utilizar el método showOpenDialog de la clase JFileChooser con el 
fin de mostrar un selector de activos para buscar archivos que necesite abrir, 
y puede utilizar el método showSaveDialog para mostrar un selector de 
archivos con el fin de especificar el nombre de archivo y vía de acceso que 
desea utilizar para guardar un archivo. Estos métodos devuelven los siguien- 
tes valores: 


e APPROVE-OPTZON. Se devuelve si el usuario hace clic sobre un 
botón de aprobación, Guardar o Abrir. 


e CANCEL-OPTION. Se devuelvesi el usuario hace clic sobre Cancelar. 
e ERROR- OPTION. Se devuelve si existe un error. 


Puede obtener el archivo seleccionado como un objeto File con el método 
getSelectedFile del selector de archivos (examinaremos la clase File en este 
libro más tarde) y puede utilizar los métodos getPath, getName y otros de la 
clase File para devolver información sobre el archivo. 

Vamos a examinar un ejemplo que hace funcionar todo esto. En este caso, 
visualizaremos un selector de apertura de archivos cuando el usuario hace 
clic sobre un botón. Permitimos que el usuario seleccione un archivo y 
después visualizaremos el nombre del archivo y su vía de acceso en un campo 
de texto. Debido a que normalmente no abrimos archivos desde los applet 
(por razones de seguridad), haremos que este ejemplo sea una aplicación. 
Aquí tenemos el código (observe que comprobamos el valor de retorno de 
showOpenDialog para ver si el usuario ha hecho clic sobre el botón Abrir 
antes de visualizar el nombre de archivo en el campo): 

import java.awt.*; 

import java.io.File; 


import jJavax.swing.*; 
import java.awt.event.*; 


import javax.swing.filechooser.*; 


public class filechooser extends JFrame implements ActionListener 


{ 
JTileChooser chooeer = nem JFileChoosero; 


JButton jbutton = new JButton ("MOstrar selector de archivos"); 
JTextField jtextfield= new JTextField (30); 


public filechooser() 
{ 
super () ; 


> 


Container contentpane = getContentPane0; 


public void actionPerformed(ActionEvent e) 
{ 
int result = chooser .ehowOpenDialog (null); 
File fileobj = chooser.getSelectedFile0; 
if (result == J'FileChooser.APPROVE-OPTION) { 
jtextfield.setText ("Su selección "4 fileobj.get~ath()); 
} else if(result == JFileChooser-CANCEL-OPTION) { 
jtextfield.set~ext ("Hiz0 clic sobre Cancelar"); 


1 


public static void main(String argsil) 
{ 
JFrame f = new filechooser(); 
f.setBounds (200, 200, 400, 200); 


aAdWindowListan naw WindowAdapter iji 


public void windowClosing (WindowEvent e) 
{ 
System.exit (0); 


1); 


La figura 14.13 muestra el selector de archivos que visualiza esta aplica- 
ción. El usuario puede explorar y seleccionar un archivo. Cuando lo hace, ya 
sea resaltando un archivo, haciendo clic sobre el botón Abrir en el selector de 
archivos o simplemente haciendo doble clic sobre el archivo en el selector de 


archivos, se cierra el selector de archivos y aparecen el nombre y vía de 
acceso del archivo seleccionado en el campo de texto de la aplicación, como 
se muestra en la figura 14.14. Eso es todo. Este ejemplo se encuentra en el 
archivo filechooser.java del CD. 
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Figura 14.14. Determinación del archivo seleccionado. 


Creación de filtros para selectores de archivo 


Existen muchas formas de personalizar los electores de archivo y una de 
ellas es crearfiltros de archivos. Puede utilizar filtros para asignar los tipos 
de archivos (basándose en su extensión) que mostrará un selector de archivos. 
Los filtros de archivos derivan de la clase FileFilter. Para añadir un filtro de 
archivos a un selector, utilice el método addChoosableFileFilter de JFile- 
Chooser. 

Vamos a examinar un ejemplo en el que añadimos dos nuevos filtros de 
archivo a un selector; un filtro para archivos .GIF y otro para archivos .Java. 
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Estos dos filtros están soportados por las clases filterl y filter2, por lo que 
podemos utilizar el método addChoosableFileFilter para añadirlos a un selector 
de archivos, como se realiza a continuación: 


import java.io.*; 
import Java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 
po 

i¡APPLET 


CODE = filechooserfilter.class 
WIDTH = 200 
HEIGHT = 200 > 
</APPLET> 
g 


public class filechooserfilterextends JFrame implements ~ction~istener 
( 
JFileChooser jfilechooser = new JFileChoosero; 
JButton jbutton = new JButton("MOstrarel selector de archivos"); 
JTextField jtextfield = new JTextField(20); 


public filechooserfilterO 
I 
super () ; 
Container contentpane = getContentPane0; 


contentPane.sotLafout new FlowLayout iij 


content Pane. add (¡button 
antent Pane. add (jtextliclidi: 


button- addict ionListener thll 


iileshcossr.addcbcomableFileFllterinow Pilteri()); 
jiilechossar.adólboomableFileFiltar(new iilterd(); 


public void action-erformed (ActionEvente) 


I 


int result = jfilechooser.showOpenDialog(null); 


if (result == JFileChooser.APPROVE-OPTION) ( 
Jjtextfield.setText ("Suselección es " + 
jfilechooser.getSelectedFileO0.getPatho Í; 


public static void main(String aíl) 
t 


JFrame jframe = new filechoocerfilterO; 


jframe.addWindowListener (new WindowAdapterO ( 
public void windowClosing(WindowEvent e) 


{ 
System.exit (0); 


Tabla 14.20. Métodos de la clase FileFilter. 


Método Descripción 


abstract boolean accept(Filef) Devuelve cierto si se acepta el archi- 
vo por este filtro. 


abstract String getDescription() Devuelve ladescripción de este filtro. 


Ahora hemos creado las clases filterl y filter2. Estas clases derivan de la 
clase abstracta FileFilter y encontraremos los métodos de esta claseen la tabla 
14.20. 

No es difícil implementar los métodos de la clase FileFilter; el método 
accept recibe un objeto File (veremos la clase File más tarde en este libro). 
Devuelve verdadero si el archivo se debe visualizar (es decir, si su extensión 
es una de las que acepta el filtro o, normalmente, si el archivo corresponde a 
un directorio) y false en otro caso. El método getDescription devuelve una 
cadena que visualizará el selector de archivos para indicar al usuario los tipos 
de archivos para los que vale el filtro. La clase filterl aceptará archivos .gif 
(descritos como "Archivos GIF (* gif) "en este filtro) y directorios, y la clase 
filter2 filtra archivos .Java (descritos como "Archivos Java (*.Java)" en este 
filtro) y directorios. Aquí tenemos el código de estas clases: 


class filterl extends javax.swing.filechooser.FileFiltel 
I 

public boolean accept (File fileobj) 

I 


String extension = “"; 


if(fileobj.getPath”).lastIndex0f('.') > 0) 
extension = fileobj.getPath() .substring( 
fileobj.getPath0 .lastIndex0f('.') 
+ 1) .toLowerCaseo; 


if (extension != "") 


return extension.equals ("gif"); 
else 
return fileobj.isDirectory0; 


1 


public String getDescription0 
I 
return "Archivos Gif (*.gif)"; 


1 


class filter2 extends javax.swing.filechooser.FileFilter 
{ 
public boolean accept (File fileobj) 


{ 


String extension = “"; 


if(fileobj.getPath().lastindex0f('.') > 0) 
extension = fileobJ.getPath0 .substringl( 
fileobj.getPath0 .lastIndex0f ('.') 
+ 1) .toLowerCaseo; 


ifiorension 1= **] 
return extension.equals ("java"); 
else 


return fileobj.isDirectory(); 


public String getDescription0 
{ 


return "Archivos Java (*.java)"; 
1 
1 


Y eso es todo. El resultado de este código se muestra en la figura 14.15, 
donde puede ver el filtro .java en acción. El uso de filtros como este, puede 
facilitar al usuario la búsqueda de archivos de un tipo particular. Este ejemplo 
es un éxito y puede encontrar el archivo filechooserfilter.java en el CD. 
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Figura 14.15. Uso de los filtros en un selector de filtros. 


m Swing: paneles 


de capas, 
de lenguetas, 
separadores 


istribuciones 


En este capítulo, examinaremos algunos de los contenedores de poco peso 
de la Swing: paneles de capas, paneles de lengiietas y paneles de separación. 
La Swing proporciona varios continentes de poco peso, incluyendo JPanel 
(que ya se ha visto), para permitir a los programadores manejar componentes 
de forma sencilla. Los paneles de capas, introducidos en el capítulo 11, nos 
permiten especificar lacapa en los componentes que añadimos, facilitando la 
configuración del orden Z, o fijando el orden en el eje Z (que apunta hacia el 
exterior de la pantalla) de los componentes. Los paneles de lengiietas nos 
permiten ordenar los componentes como si los añadiéramos a una colección 
de archivos de carpeta de lengiletas, y podemos hacer clic sobre las lengüetas 
para abrir cada carpeta. Finalmente los paneles de separación no permiten 
visualizar dos componentes colindantes y ajustar la cantidad visible de cada 
uno; una técnica usada habitualmente para soportar dos vistas del mismo 
modelo. También examinaremos la distribución en este capítulo. Primero 
vimos la distribución del AWT en el capítulo 7. La Swing soporta todas estas 
distribuciones y dos más: distribución de cuadro y distribución de superposi- 
ción. Examinaremos estas dos nuevas distribuciones en este capítulo. La 
distribución de cuadro nos permite crear filas de columnas de componentes. 
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La distribución superpuesta, como implica el nombre, nos permite dibujar 
componentes superpuestos. La Swing también define la clase Box, que nos 
permite distribuir componentes utilizando estructuras visuales, cruces, áreas 
rígidas y pegadas. Veremos todo en este capítulo. 


Paneles de capas 


Los paneles de capas, contenedores de poco peso, son paneles importantes 
para los contenedores de alto peso de la Swing como JApplet y JFrame. Los 
paneles de capas se dividen en varias capas verticales que pueden trabajar 
conjuntamente con la Swing. Esta es una de las áreas en las que la 
implementación de la Swing sobre AWT no es transparente para el programa- 
dor, debido a que puede ver las capas que utiliza la Swing para visualizar los 
cuadros de diálogo, arrastrar componentes, menús emergentes y otros. Uno 
de los aspectos más populares del panel de capas es que es la raíz del panel de 
contención. 


Paneles de lengúuetas 


Los cuadros de diálogo que permiten a los usuarios seleccionar entre 
muchas opciones han cambiado a medida que los programas se han hecho 
más complejos y ofrecían más opciones. Se implementan personalizadamente 
de esta forma, organizando la configuración del programa en lengiietas para 
la pantalla, información de usuario, opciones generales, archivos y otras. La 
Swing soporta ahora paneles de lengüetas para permitirle crear cuadros de 
diálogo y programas de esta clase. Como es de esperar, todas las capacidades 
de la Swing están disponibles aquí, como la visualización de imágenes de 
lengiietas. 


Paneles de separación 
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Otra técnica popular de programación de las IU hoy día es permitir al 
usuario dividir una vista en un modelo de datos, creando de esta forma una 
nueva vista con los datos. Los procesadores de texto a veces permiten a los 
usuarios dividir sus presentaciones en dos paneles de tal forma que puedan 
pasar de forma independiente entre dos áreas de un documento. La Swing 
soporta los paneles de separación para permitir a los programas presentar dos 


componentes conjuntamente. Estos componentes pueden representar vistas 
del mismo u otro modelo de datos. 


Distribución 


En el capítulo 7 examinamos la distribución del AWT, y la Swing soporta 
estas distribuciones asícomo dos más: distribución de cuadro y distribución 
superpuesta. Examinaremos estas dos nuevas distribuciones en este capítulo. 
De las dos, la distribución de cuadro es la más popular, debido a que permite 
distribuir los componentes en filas y columnas horizontales y verticales, 
llamados cuadros. De hecho, la Swing también soporta una clase Box que va 
más allá, permitiendo especificar el espacio de distribución de componentes, 
como examinaremos. El gestor de distribución de superposición nos permite 
superponer componentes de una forma bien definida y, aunque no es tan 
común como los otros sectores de distribución, tiene su utilidad. 

Es suficiente para el resumen de lo que aparece en este capítulo. Como 
puede ver, vendrá mucho más. Es el momento de pasar a la sección inicial, 
comenzando con una descripción de los componentes de desplazamiento de 
la Swing. 


Comprensión de los componentes de la Swing y 
el orden Z 


"Java ha fallado de nuevo”, dice el programador novato. "Deposité algu- 
nos componentes en la misma zona de mi programa por error y aparecían 
unos encima de otros". Sonreímos y decimos, "Es perfectamente posible. De 
hecho, en la Swing no está fuera de lo común superponer componentes”. El 
PN dice, "¡Vaya!" 

Cuando añadimos componentes de poco peso a un panel contenedor, los 
componentes se dibujarán sencillamente sobre el panel y nada nos impide 
hacer que los componentes se superpongan. Es decir, siempre y cuando no 
utilicemos un gestor de distribución (excepto para el gestor de distribución de 
superposición) que impediría la superposición. Cuando los componentes se 
superponen, su orden Z pasa a ser muy importante; el orden Z representa el 
emplazamiento relativo de los componentes a lo largo del eje Z, que sale 
fuera de la pantalla. El componente de poco peso que se haya añadido prime- 
ro aparecerá por encima de aquellos que se añadan posteriormente. Puede 
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también añadir componentes pesados de la AWT a su programa y esos com- 
ponentes, que tienen su propio sistema operativo de ventanas, normalmente 
aparecerán por encima de los componentes de la Swing. 

Aquí tenemos un ejemplo en el cual eliminamos el gestor de distribución 
de borde predeterminado de un panel de contenidos y añadimos una serie de 
etiquetas superpuestas, mostrando de esta forma que la primera etiqueta 
añadida aparecerá por encima del resto. Aquí tenemos el código (observe que 
hemos añadido un borde a las etiquetas para hacer visible la superposición): 


import Java.awt.*; 
import javax.swing.*; 


pe 
CAPPLET 
CODE = layered.class 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
"y 


public class layered extends JApplet 
JLabel labels [l ; 
public void hit () 
i Container contentpane = getContentPane0; 


contentPane.setlLayout (null); 


labels = new JLabell61; 


labels[O] = new JLabel ("Etiqueta 0") ; 
labels[01l.setOpaque (true); 

labels[0].setBorder (BorderFa-tory.createEtchedBordero); 
contentPane.add (labels [01); 


labels[1] = new -Label"Etiqueta 1"); 

labels [11. setopaque (true); 

labels[11.set-order (BorderFactory.createEtchedBorder~; 
contentPane.add(labeIs[11); 


labels[2] = new --abel ("Etiquet'); 
labels[2].setOpaque (true); 

labels[2] ..set-order(“-order-actory.createEtchedB0de- 
contentPane.add (labels[21 1; 


labels[3] = new “Label ("Etiqueta"); 


labels[4] = new J-abel ("EtiquetaA"); 


labelsr41 .setOpaque (true); 
labels[4].setBorder (BorderFactory.createEtchedBorder (~~; 
contentpane.add (labels141) ; 


labels [S] = new JLabel ("Etiqueta 5"); 

labels/S] .setopaque (true); 

labels[5].set-order (BOrderFa-t0ry.-“reateEtched-order () 
contentPane.add (labelsi51) ; 


for (int loop—index = 0; loop—index < 6; loop-index++) ( 


labels [loop-indexl1 .setBounds (40* loop—index, 40 * loop—index, 
100, 60); 


Ca 


Figura 15.1. Controles superpuestos. 


El resultado se muestra en la figura 15.1. Como ve, la primera etiqueta 
añadida aparece por encima de las otras. La siguiente etiqueta añadida apare- 
ce por encima de las posteriores y así sucesivamente, definiendo de esta 
forma un orden Z distinto para cada etiqueta. Este ejemplo se encuentra en el 
archivo layered.java del CD. 

Debe también observar que hemos utilizado el método setopaque para 
cada etiqueta con el fin de asegurar que las etiquetas que quedan por debajo 
no se muestren de ninguna forma; consulte el siguiente tema para obtener 
más detalles. 


Transparencia en los componentes de la Swing 


"Acabo de ver el programa más extraño", dice el programador novato. 
"Realmente podía ver todos los controles como si fueran transparentes". "No 
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esextraño", decimos. "De hecho, muchos programas de la Swing lo hacen d 1 
forma intencionada”. "¡Dígame más!" Dice el PN. 

Debido a que los controles de poco peso simplemente se dibujan dentro dë 
sus contenedores, podemos hacerlos transparentes. Cuando hacemos un con- 
trol transparente, no pinta su fondo cuando lo dibujamos o repintamos, de tal 
forma que los controles por debajo se pueden ver. Esta es una técnica amplia- 
mente utilizada que nos permite hacer que su apariencia sea como si dibujára- 
mos componentes que fueran irregulares y no rectangulares. 

En el tema anterior, escribimos un ejemplo en el que mostramos etiquetafl 
opacas superpuestas de la Swing, pero también explícitamente podemos ha- 
cerlas transparentes. Puede asignar la transparencia de los componentes de la 
Swing con el método setopaque. A continuación mostramos cómo hacer que 
las etiquetas del ejemplo del tema anterior sean transparentes (de hecho, las 
llamadas a setopaque son realmente innecesarias aquí debido a que la confi- 
guración predeterminada para etiquetas es hacerlas transparentes): 


import Java.awt.*; 
import javax.swing.*; 
/° 

<APPLET 


CODE = layered.class 
WIDTH = 350 
HEIGHT = 280 > 


public clasc layered extends JApplet 


I 
JLabel labels[1 ; 


public void hit () 
( 
Container contentpane = getContentPane0; 
contentPane.setLayout (nulli 


> 


labels = new JLabelr61; 


labels [O] = new JLabel("Etiqueta 0”) ; 

lh 1 s[0]. aetOpaque (false); 

labels[0] .setBorder (BorderFactory.createEtchedBordero ); 
contentPane.add (labels[01): 


labels[1] = new JLabel ("Etiqueta 1"); 
labele[1] . setO0paque (false); 

labels[1].setBorder (-order-actory.create-tchedBordeto 
contentPane.add (labels[11 ) ; 


labels[2] = new --abel ("Etiquet2Y'); 
labela[Z] . setOpaque (false); 


100. 60); 


+ + Dor y a 
ntar ani i Jar 


labels[3] = new JLabelíMEtiqueta3"); 

labels[3].setO0pa-we (falSe); 
labels[3].set--rder(B0O0rderFa-t-ry.“reate-tchedBordero); 
contentPane.add (label--"31); 


labels[4] = new JLabel ("Etiqueta 4") ; 

labels[4] .eetOpaqueífalse) ; 
labels[4].setB0rder(BorderFa-t0ry.-”-reate-hd0Od; 
contentPane.add (label- [41); 


labels[5] = new JLabel ("Etiqueta 5"); 

labels 151. eetOpaque (false) 5 

labels[5].setBorder (BorderFa-tory.-“reateEt-hedB0rde-0-; 
contentPane.add (labels[51); 


for (int loop-index = O; loop—index = 6; loop-index++) 1 
labels[loop-index] .setBounds (40 loop—index, 40 loop-index, 


El resultado se muestra en la figura 15.2, donde puede ver las etiquetas 
transparentes superpuestas. 

Observe que existe una forma explícita de manejar controles superpuestos 
sin configurar nuestro propio gestor de distribución. Esto involucra a un 
panel de capas que podemos utilizar en la mayoría de los programas. Consul- 
te el siguiente tema para obtener más detalles. 
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Figura 15.2. Transparencia de controles. 


Uso de paneles de capas 
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"Tengo algún problema", dice el programador novato. "Quiero permitir al 
usuario arrastrar componentes en un contenedor de la Swing, pero cuando los 
componentes se arrastran, pasan por encima de unos componentes y por 
debajo de otros". Responde: "eso se debe a que tiene que tener en cuenta que 
los componentes de la Swing se presentan en capas. Debería poner lo que 
desea arrastrar en la capa de arrastre". "¿Cómo es eso?", pregunta el PN. 

El panel de capas dentro del panel raíz contiene los componentes reales 
que aparecen en los applet y aplicaciones, incluyendo barras de menú y el 
panel de contenido. Aquí tenemos el diagrama de herencia para la clase del 
panel de capas, JLayeredPane: 


java.lang.Object 


JLayeredPane divide su rango de profundidad en varias capas distintas. Al 
situar un componente en una de estas capas es más sencillo asegurarnos de 
esta forma de que el componente se superpone de forma adecuada, sin tener 
que preocuparnos de la especificación de números para asignar profundida- 
des específicas: 


e DEFAULT-LAYER. La capa estándar más baja, donde se sitúan la 
mayoría de los componentes. 

e PALETTE-LAYER. La capa de paleta está situada por encima de la 
capa por defecto y se utiliza para las barras de herramientas y paletas 
flotantes. 


e MODAL-LAYER. La capa utilizada por los cuadros de diálogo moda- 
les. 


e POPUP-LAYER. La capa emergente se visualiza sobre la capa de 
diálogo. 


e DRAG-LAYER. Cuando arrastramos un componente, asignado a la 
capa de arrastre, nos aseguramos de que queda posicionado sobre todos 
los demás componentes en el contenido. 


Puede utilizar los métodos moveToFront, moveToBack y setposition de 
JLayeredPane para reposicionar un componente dentro de su capa. El método 
setLayer también se puede utilizar para cambiar la capa actual del componen- 
te. Examinamos en el capítulo 11 JLayeredPane y podemos encontrar los 
campos de la clase JLayeredPane en la tabla 11.10, su constructor en la tabla 
11.11 ysusmétodosenlatabla 11.12. 

Aquí tenemos un ejemplo que muestra cómo añadir componentes a un 
panel de capas. En este caso, reemplazamos el panel de contenido de un 
applet con un nuevo panel de capas y añadimos una etiqueta a cada etapa 
estándar. Para asignar la capa actual en el panel de capas, utilizamos el 
método setLayer y para especificar la capa que utilizamos, utilizamos las 
constantes definidas en la clase JLayeredPane, como JLayeredPane. 
PALETTE-LAYER. Una curiosidad de la Swing es que las constantes como 
JLayeredPane .PALETTE-—LAYERson, en realidad, objetos Integer, no ente- 
ros. No obstante, los métodos como setLayer necesitan enteros, por lo que 
debemos usar el método intValue de la clase Integer para convertir estas 
constantes a valores útiles, como a continuación: 


Aquí añadimos etiquetas a todas las capas descritas en la lista anterior: 


import java.awt.*; 
import javax.swing.*; 


EE 
<APPLET 
CODE = layeredpane.class 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
* 
/ 
public class layeredpane extends JApplet 


( 


JLayeredPane jlayeredpane = new JLayeredPaneO0; 


public void init () 


labels = new JLabelt61; 


labels[0] = new JLabel ("Capa de contenido"); 
labels[Ol .setOpaque (true); 


labels[1] = new JLabel ("Capapredeterminada"); 
labels [11 . setopaque true); 
labels[1].setBorder (BorderFactory.createEtchedBorder ()); 
jlayeredpane.setlayer(labels[1], 
JLayeredPane.DEFAULT-LAYER.intValue0 ); 
jlayeredpane.add (labels[1]); 


labels[2] = new JLabel ("Capade paleta"); 
labels[2] .setOpaque (true); 
labels[2] .setBorder (BorderFactory.createEtchedBorder ()); 
jlayeredpane.-”vetlLayer(labels[2], 
JLayeredPane.PALETTE-LAYER.intValue0 ) 
jlayeredpane.add (labels[2]): 


labels[3] = new JLabel ("Capamodal"); 
labels [3] . setOpaque (true); 
labels[3].setBorder (BorderFactory.createEtchedBorder (); 


labels[4] = new JLabel ("Capaemergente"); 
labels 141. setopaque(true) ; 
labels[4] .set-order (BorderFactory.createEtchedBorder ()); 
jlayeredpane.”vetlayer(labelc[41, 
JLayeredPane.POPUP-LAYER.intValueoO ); 
jlayeredpane.add (labels[4]); 


labels 151 = new ~ -abe"tadpa de arrastre"); 
labels [SI .setopaque true); 
labels[5].set-order (~orderFactory.~reateEtchedBordęr~~ 
jlayeredpane.~etLayer(labels[51, 
JLayeredPane.DRAG-LAYER.intValue0 ); 
jlayeredpane.add (labels[5)); 


for (int loop-index = 0; loop-—index < 6; loop-index++) { 
labels[loop—index] . setBounds (40 * loop—index, 40 * loop-index, 
100, 60); 
1 
1 


El resultado de este código se muestra en la figura 15.3, donde puede ver 
qué capas están por encima de otras. Ahora ya hemos trabajado con todas lag 
capas estándar en un panel de capas (también podemos definir nuestras pro- 
pias capas de forma numérica). Este ejemplo se encuentra en el archivo 
layeredpane.java del CD. 


Como se muestra en la figura 15.3, puede observar que la capa de arrastre 
aparece por encima, lo que tiene sentido debido a que queremos que los 
componentes que el usuario arrastre pasen por encima de otros componentes. 
Para implementar el arrastre utilizando la capa de arrastre, podemos añadir el 
componente que queramos arrastrar a la capa de arrastre, asegurando que el 
gestor de distribución se haya asignado a nulo y después utilizar el método 
setLocation del componente para situarlo como respuesta a las acciones de 
ratón del usuario. 
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Figura 15.3. Adición de componentes a un panel de capas. 


Creación de paneles de lengúetas 


"Vaya", diceel programador novato. "Mi programa tiene tantas configura- 
ciones ahora que el cuadro de diálogo de configuración es mayor que la 
pantalla". "¿Cuánto mayor? ", preguntamos. "Como cuatro veces", dice el 
PN. "Ah", decimos, "parece que es el momento de distribuir estas opciones 
utilizando un panel de lengüetas". 

Los paneles de lengiietas proporcionan una forma cómoda de distribuir 
muchos componentes en un espacio pequeño. Presenta al usuario una vista 
basada en las lengüetas de las carpetas de archivo y cuando el usuario hace 
clic sobre las diversas lengüetas, parece que se abren las distintas "carpetas" 
mostrando un nuevo panel completo de componentes. Los paneles de lengüe- 
tas quedan soportados en la Swing con la clase JTabbedPane y aquí tenemos 
el diagrama de herencia para esta clase: 


java.lang.Object 


La tabla 15.1 muestra los campos para la clase JTabbedPane, la tabla 15.2 
sus constructores y la tabla 15.3 sus métodos. 


Tabla 15.1. Campos de la clase JTabbedPane 


Campo Descripción 


protected ChangeEvent changeEvent El ChangeEvent. 

protected ChangeListener changelistener El ChangeListener añadido al 
modelo. 

protected SingleSelectionModel model El modelo de selección prede- 
terminado. 

protected int tabplacement Dónde situamos las lengúe- 
tas. 


Tabla 15.2. Constructores de la clase JTabbedPane. 


Constructor Descripción 


JTabbedPanel[) Construye un JTabbedPane 
vacío. 
JTabbedPane(inttabplacement) Construye un JTabbedPane 


vacío con la disposición de 
lengúetas indicada por TOP, 
BOTTOM, LEFT, o RIGHT. 


Tabla 15.3. Métodos de la clase JTabbedPane. 


Método Descripción 


Component add(Component component) Añade un componente. 


Component add(Component component, Añade un componente en la 
int index) posición de lengúeta indicada 
por el índice. 


void add(Component component, Object Añade un componente al 
constraints) panel de lengúetas. 


void add(Component component, Object Añade un componente al 
constraints, int index) índice de lengúetas indicado. 


Método 


Cornponent add(String title, Component 


component) 


void addChangeListener(ChangeListener 7) 


void addTab(String title, Component com- 


ponent) 


void addTab(String title, Icon icon, Compo- 


nent component) 


void addTab(String title, Icon icon, Com- 


ponent component, String tip) 


protected ChangeListener createchange- 


Listener() 


protected void fireStateChangedO 


AccessibleContext getAccessibleContext() 


Color getBackgroundAt(int index) 
Rectangle getBoundsAt(int index) 
Component getComponentAt(int index) 
Icon getDisablediconAt(intindex) 


Color getForegroundAt(int index) 


Icon geticonAt(int index) 


Descripción 


Añade un componente con un 
título de lengúetas indicado. 


Añade un ChangeListener a 
este panel de lengúetas. 


Añade una lengúeta represen- 
tada por un título y un icono. 


Añade la lengúeta represen- 
tada por un título y10 icono, 
pudiendo ser cualquiera de 
los dos nulos. 


Añade una lengúeta de ayu- 
da representada por un título 
y10 icono, cualquiera de los 
cuales puede ser nulo. 


Sobreescribe éste método 
para devolver una subclase 
de ModelListener u otra im- 
plementación de ChangeListe- 
ner. 


Envía un ChangeEventa ca- 
da receptor. 


Obtiene el AccessibleContext 
asociado con este JCompo- 
nent. 


Obtiene el color de fondo de 
lengúetas en index. 


Obtiene los límites de len- 
gúetas en index. 


Obtiene el componente en 
index. 


Obtiene el icono de la len- 
gúeta deshabilitada en index. 


Obtiene el color de primer 
plano de la lengúeta en index. 


Obtiene elicono de lengúetas 
en index. 
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Método 


SingleSelectionModelgetModel() 


ComponentgetSelectedComponent() 


| int getSelectedindex() 


int getTabCount() 


int getTabPlacement0 


int getTabRunCount() 


String getTitleAt(int index) 


String getToolTipText(MouseEvent event) 


TabbedPanellll gatU) 


String getUlClassID() 


int indexOfComponent(Component compo- 
nent) 


int indexOfTab(Icon icon) 


int indexOf Tab(String title) 


Descripción 


Obtiene el modelo asociado 
con este panel de lengúetas. 


Obtiene el componente se- 
leccionadoen curso para este 
panel de lengúetas. 


Obtiene el índice seleccio- 
nado actual para este panel 
de lengúetas. 


Obtiene el número de lengúe- 
tasdeeste panel de lengúetas. 


Obtiene la situación de las 
lengúetas para este panel de 
lengUetas. 


Obtiene el número de lengúe- 
tas en ejecución actualmente 
en uso para visualizar lengúe- 
tas. 


Obtiene el título de la lengúe- 
ta en index. 


Obtiene el texto de la ayuda 
de herramientas para el com- 
ponente determinado por la 
posición del evento de ratón. 


Obtiene el objeto IU que 
implementa la apariencia de 
este componente. 


Obtiene el nombre dela clase 
lUque implementala aparien- 
cia de este componente. 


Obtiene el índice del com- 
ponente lengúeta indicado. 


Obtieneel índicede la primera 
de las lengúetas con un icono 
dado. 


Obtieneel índicede laprimera 
lengúeta con un título dado y 
devuelve -1 si no existen 
lengúetas con este título. 


Metodo Descripción 


void insertTab(Stringtitle, Icon icon, Com- Inserta un componente repre- 
ponent component, String tip, int index) sentado por un título e icono. 
boolean isEnabledAt(int index) Obtienesi la lengúetaen index 
está actualmente habilitada. 
| protected String paramString() Obtiene una representación 
de cadena de este JTabbed- 
Pane. 
void remove(Componentcomponent) Elimina la lengúeta que 
corresponde al componente 
indicado. 
void removeAll() Elimina todas las lengúetas 


del panel de lengúetas. 


void removeChangeListener(ChangeListe- Eliminaun ChangeListenerde 
ner 7) este panel de lengúetas. 


void removeTabAt(int index) Elimina la lengúeta en index. 


void setBackgroundAt(intindex, Color back-  Asigna el color de fondo. 
ground) 


void setComponentAt(intindex, Component Asigna el componente en in- 


component) dex a Component. 

void setDisablediconAt(intindex, Icon disa-  Asigna el icono inhabilitado 

bledicon) en index a Icono, que puede 
ser nulo. 


void setEnabledAt(intindex, boolean enabled) Asigna si la lengúeta en index 
está habilitada. 


void setForegroundAt(int index, Color fore-  Asigna el color de primer pla- 
ground) no. 


void seticonAt(int index, Icon icon) Asigna el icono. 


void setModel(SingleSetectionModelmodel) Asigna al modelo a utilizar 
con este panel de lengúetas. 


void setSelectedComponent(Componentc) Asigna el componente se- 
leccionado por este panel de 
lengúetas. 


void setSelectedIndex(intindex) Asignaelíndice seleccionado | 
para este panel de lengúetas. | 
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Método Descripción 


void setTabPlacement (inttabplacement) Asigna la posición de las 
lengüetas para este panel de 
lengietas. 


void setTitleAt(int index, String title) Asigna el título. 


void setUl(TabbedPaneU 1 ul) Asigna el objeto IU que im- 
plementa la apariencia deeste 
componente. 


void update UIO Llamado por UlManagercuan- 
do cambia la apariencia. 


Un ejemplo lo dejará más claro. En este caso, crearemos un panel de 
lengüetas con tres lengüetas y damos a cada una de ellas su propio objeto 
JPanel conteniendo una etiqueta. El usuario será capaz de pasar de una len- 
güeta a otra, visualizando todas las etiquetas sucesivamente. Comenzaremos 
creando los paneles: 


` ` * 
import Java.awt. ; 
import javax.swing.*; 


Je 
<APPLET 
CODE = tabbedpane.class 
WIDTH = 400 
HEIGHT = 200 > 
</APPLET> 
*7 


public class tabbedpane extends JApplet 
( 
public void inito0 


I 


Container contentpane = getContentPane0; 


JPanel jpanell new J'Panelo; 
JPanel jpanel2 = new J'Panelo; 
JPanel jpanel3 = new ¡Panel (); 


jpanell.add(new JLabel ("Este es el panel 1")); 
jpanell.add (new JLabel ("Este es el panel 2")); 
jpanel3.add (new JLabel ("Este es el panel 3")); 


Ahora, estamos listos para añadir posteriormente paneles a un panel de 
lengiietas, por lo que crearemos un nuevo panel y utilizamos el método 


addTab para añadirle 3 lengietas. Pasaremos a addTab los títulos de cada 
lengüeta, los iconos de imagen que vamos a utilizar ellas, los componentes 
que añadiremos a cada una (que normalmente serán objetos de la clase 
JPanel) y una ayuda de herramientas para cada una de las lengietas como si- 
gue: 


public class tabbedpane extends JApplet 


( 
public void hito 


{ 


Container contentpane = getContentPane0; 
JTabbedPane jtabbedpane = new JTabbedPane0; 


JPanel jpanell = new JPaneloO; 
manel jpanel2 = new JPaneloO; 
manel jpanel3 = new JPanelo; 


jpanell .add (new JLabel ("Este es el panel 1")); 
jpanell.add (new JLabel ("E8te es el panel 2")); 
jpanel3.add (new JLabel ("Este es el panel 3")); 


jtabbedpane .addTab ("Lengúet8 lm, 
new Imagelcon ("tab.j3Jpg"), 
jpanell, "Estaes la lengúeta 1"); 


jtabbedpsne.addTab ("Lengúeta 2". 
new Imagelcon ("tab.Jpgm), 
jpanel2, "Esta es la lengúeta 2"); 


jtabbedpane.addTab ("Lengiieta tres", 
new Imagelcon("tab.jpgm , 
jpanel3, "Esta es la lengúeta 3"); 


contentFane.stlayout (new Borderlayout (111 
gontant Pans . add (Sta bobadas | y 


La figura 15.4 muestra el resultado. Como se ve, cada lengileta tiene su 
propia imagen y título, como especifica el método addTab. Si hacemos clic 
sobre una nueva lengiieta abrimos una nueva "carpeta" que contiene una 
etiqueta. 

Eso es todo. Este ejemplo se encuentra en el archivo tabbedpane.java del 
CD. 

Puede hacer mucho más con paneles de lengiietas; también puede especifi- 
car la posición de las lengúetas, por ejemplo. Consulte el siguiente tema para 
más detalles. 
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Figura 15.4. Creación de un panel de lengüetas. 


Especificación de la posición de las lengüetas en 
los paneles de lengüetas 


El gran jefe mira por encima de su hombro y dice, "No, no, todo está mal; 
las lengüetas debían ir al lado izquierdo". "Cambia de opinión continuamen- 
te", le contesta. "¿Está seguro de que quiere las etiquetas a la izquierda?" 
"No, no", dice el jefe, "en el lado derecho, como he dicho". 

Podemos especificar dónde aparecen las lengietas en un panel (arriba, 
abajo, izquierda o derecha) utilizando el método setTabPlacement. Aquí te- 
nemos un ejemplo que muestra cómo funciona. En este caso, permitimos al 
usuario seleccionar la orientación de las lengüetas en un panel de lengiietas 
(izquierda, derecha, arriba o abajo) haciendo clic sobre un botón. Aquí tene- 
mos el código: 


import java.awt. *; 
import javax.swing.*; 
import java.awt.event.*; 


pe 
<APPLET 
CODE = tabbedpaneorientation.class 
WIDTH = 500 
HEIGHT = 200 z 
</APPLET> 
E 


public class tabbedpaneorientationextendsJAppletimplementsActionListe--- 


( 
JTabbedPane jtabbedpane = new ““abbed-ane (SwingConstants.BOTTOM) : 


JButton buttonl1l, button2, button3, button4; 


public void hitoO0 


Container contentpane = getContentPane0; 
JPanel buttonpanel = new JPanel(): 

JPanel jpanell = new JPanelO; 

JPanel jpanel2 = new JPanelO; 

JPanel jpanel3 = new JPanelO; 

itabbedpana. cetTabFlacamant (TTabbeliPans. T01 
Jjtabbedpane. addTab(“Panel 1”, 


new Imagelcon("tab.Jpg"), 
Jjpanell, "Este es el panel 1"); 


jtabbedpane. addTab(“Panel 2", 
new Imagelcon("tab.Jpg"), 
Jpanel2, "Este es el panel 2"); 


jtabbedpane.addTab ("Panel 3”, 
new Imagelconí"tab.Jpg"), 
Jjpanel3, "Este es el panel 3"); 


buttonl = new JButton ("Arribam); 
button2 = new JButton("lzquierda"); 
button3 new JB-tton(“-Derecha-); 
button4 = new JB-tton (“Abajo”); 


bittontansl. add ¿button ii 
buttonPanel. add button]; 
bittosTfansl. add button) j 
buttonPanal,. add ¿buttond l; 


bhebroni,addictioaListanér |this) } 
button]. aðdääctiontistererithis) p 
button]. addictionld tener (this) 
burttosd. addñctioaListaner (Chia) ¿ 


spñtentPane, set Layout (new BorderLayout i 


ant Pane add] tabla 


antPane, add [ButzonPan 


public void actionPerformed (ActionEvent e) 
{ 


if(e.getSource0 == buttonl) C 
jtabbedpane.set-ab-lacement (mabbedPane .TOP) ; 

1 

else if(e.getSource0 == button2) { 
jt&bedpane . set-¿-lacement (jTabbed-ane.LEFT); 

1 

else if(e.getSource0 == button3) ( 
jtabbedpane.set-ab-lacement (JTabbedPane-RIGHT); 

1 
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Figura 15.5. Creación de un panel de lengüetas. 


La figura 15.5 muestra el resultado de este código. Cuando el usuario hac? 
clic sobre un botón, el panel de lengüetas responde visualizando las lengüetas 
en la orientación correspondiente, permitiendo a los usuarios personalizar el 
panel a su gusto. El gran jefe estaría orgulloso. Este ejemplo se encuentra en 
el archivo tabbedpaneorientation.java del CD. 


Uso de paneles de separación 


El especialista de soporte a productos vuelve y no está feliz. "Los usuario? 
comentan sobre nuestro nuevo programa procesador de texto", dice el ESP. 
"Cuando editan un documento de más de mil páginas y tienen que hacer 
referencia a otra parte del documento, puede requerir mucho tiempo despla- 
zarse hacia arriba y hacia abajo". "¿Quién está editando documentos de más 
de mil páginas?", preguntamos. "¿Quétal si añadimos un panel de separación 
al procesador de texto?", pregunta el ESP. 

Podemos utilizar paneles de separación para visualizar dos componentez 
colindantes, que pueden incluir dos vistas del mismo modelo. Utilizando 
paneles de separación, el usuario puede gestionar dos componentes, arrastrar 
el separador entre los componentes para mostrar más o menos de cada uno 
según sea necesario. Los paneles de separación están soportados por la clase 
JSplitPane y aquí tenemos el árbol de herencia para esta clase: 


La tabla 15.4 muestra los campos de la clase JSplitPane, la tabla 15.5 
muestra sus constructores y la tabla 15.6 sus métodos. 


Tabla 15.4. Campos de la clase JSplitPane. 


Descripción 


static String BOTTOM Utilizado paraañadir un componente 
en el pie de panel. 

static String CONTINUOUS-LA- El nombre de la propiedad ligada 

YOUT-PROPERTY para continuousLayout. 

protected boolean continuousLayout Devuelvetrue silas vistas se dibujan 


continuamente mientras se cambia 
de tamaño. 


static String DIVIDER Utilizado paraañadir un componente 
que representará al divisor. 


static String DIVIDER-SIZE-PRO- Nombre de la propia ligada para el 


PERTY borde. 

protected int dividersize El tamaño del divisor. 

static int HORIZONTAL-SPLIT Un divisor horizontal indica que el 
componente se divide a lo largo del 
eje x. 

static String LAST-DIVIDER-LOCA- La propiedad ligada para lastLo- 

TION-PROPERTY cation. 

protected int lastDividerLocation La localización previa de paneles de 
separación. 

static String LEFT Utilizado para añadir un componente 


a la izquierda del otro componente. 
protected Component leftComponent Elcomponentequehay a laizquierda 


O arriba. 
static String ONE-TOUCH-EXPAN- — Lapropiedadligada para oneTouch- 
DABLE-PROPERTY Expandable. 


Campo 


protected boolean oneTouchEx- 
pandable 


protected int orientation 


static String ORIENTATION-PRO- 
PERTY 


static String RIGHT 


protected Component rightcompo- 
nent 


static String TOP 


static int VERTICAL-SPLIT 


Descripción 

Devuelve cierto si el panelde separa- 
ción es expandible con una pulsa- 
ción. 

Indica cómo se separan las vistas. 


El nombredelapropiedadligadapara 
la orientación (horizontalo vertical). 


Utilizado paraañadirun componente 
a la derecha del componente. 


El componente a la derecha o al pie. 


Utilizado para añadir un componente 
sobre otro componente. 


Una separación vertical indica que 
los componentes se dividen a lo 
largo del eje y. 


Tabla 15.5. Constructores de la clase JSplitPane. 


Constructor 


JSplitPaneli 


JSplitPane(int neworientation) 


JSplitPane(int neworientation, boo- 
lean newContinuousLayout) 


JSplitPane(int neworientation, boo- 
lean newContinuousLayout, Compo- 
nent newLefiComponent, Component 
newRightComponent) 


JSplitPane(int neworientation, Com- 
ponent newLeftComponent, Compo- 
nent newRightComponent) 


Descripción 


Construye un JSplitPane con los 
botones para los componentes. 


Construye un JSplitPane configu- 
rado con la distribución no continua 
indicada. 


Construye un JSplitPane nuevocon 
la orientación y estilo de dibujo indi- 
cados. 


Construye un JSplitPane con la 
orientación y estilo dedibujoindicados 
y con los componentes indicados. 


Construye un JSplitPane con la 
orientacióny loscomponentesespeci- 
ficados, que no realiza dibujo conti- 
nuo. 


Tabla 15.6. Métodos de la clase JSplitPane. 


Método 


protected void addlmpl(Component 
comp, Object constraints, int index) 


AccessibleContext getAccessible- 
Contexto 

Cornponent getBottomComponent() 
int getDividerLocation() 

int getDividerSize() 


int getLastDividerLocation() 


Cornponent getLeftCornponent() 


int getMaximumDividerLocation() 


int getMinirnumDividerLocation() 


int getOrientation0 
CornponentgetRightComponent() 
Cornponent getTopComponent() 


SplitPaneUl getUl() 


String getUlClassID() 


boolean isContinuousLayout() 


Descripción 


Añade comp con las limitaciones 
dadas. 


Obtiene el AccessibleContext. 


Obtiene el componente por debajo 
a la derecha del divisor. 


Obtiene la localización del divisor a 
partir de una irnplernentación de la 
apariencia. 


Obtiene el tamaño del divisor. 
Obtiene la últimaposicióndel divisor. 


Obtieneelcomponentea laizquierda 
o por encima del divisor. 


Obtiene la posición máxima del 
divisor a partir de la irmplernentación 
de la apariencia. 


Obtiene la posición mínima del 
divisor a partir de implernentación 
de la apariencia. 


Obtiene la orientación. 


Obtiene el componentea la derecha 
o por debajo del divisor. 


Obtieneelcomponentea laizquierda 
por encima del divisor. 


Obtiene el SplitPaneUl que propor- 
ciona la apariencia actual. 


Obtiene el nombre de la clase de la 
apariencia que renderiza este corn- 
ponente. 


Devuelve cierto silos componentes 
fijos se dibujan continuamente y se 
distribuyen durante la interven- 
ción del usuario. 


Método 


boolean isOneTouchExpandable() 


boolean isValidateRoot() 


protected void paintChildren(Gra- 
phics g) 
protected String paramString() 


void remove(Componentcomponent) 


void remove(int index) 
void removeAll() 


void resetToPreferredSizes() 


void setBottomComponent(Compo- 
nent comp) 


void setContinuousLayout(boolean 
newContinuousLayout) 


void setDividerLocation(double pro- 
portionalLocation) 


void setDividerLocation(int location) 
void setDividerSize(int newSize) 


void setLastDividerLocation(int new- 
LastLocation) 

void setLeftlomponent(Component 
cOr.n-) 


void setOneTouchExpandable(boo- 
lean newvalue) 


Descripción 


Devuelve cierto si el panel propor- 
ciona un elemento IU para reducir1 
expandir el divisor. 


Devuelve cierto si la raíz es válida. 
Pinta todos componentes. 


Devuelve una representación de ca- 
dena de este JSplitPane. 


Eliminael componente hijodel panel. 


Elimina el componente en el índice 
indicado. 


Elimina todo los componentes hijos 
del receptor. 


Reposiciona el JSplitPane basán- 
dose en el tamaño preferido de los 
hijos. 

Asigna el componente arriba o ala 
derecha del visor. 


Determina si los componentes fijos 
se dibujarán continuamente durante 
las acciones de usuario. 


Asigna la localización del divisor 
con un porcentaje del tamaño del 
JSplitPane. 


Asigna la localización del divisor 
Asigna el tamaño de divisor. 


Asignala última localización del divi- 
sor que estaba en newLastLocation. 


Asigna el componente a la izquierda 
o en la parte superior del divisor. 


Determina si JSplitPaneproporciona 
un elemento IU del divisor para ex- 
pandirlreducirrápidamenteel divisor. 


Método Descripción 


void setOrientation(int orientation) Asigna la orientación o la división 
del separador. 


void setRightComponent(Component Asigna el componente a la derecha 
comp) o por debajo del divisor. 


void setTopComponent(Component — Asignael componente por encima o 
comp) a la izquierda del separador. 


void setUl(SplitPaneU1 uj) Asigna el objeto apariencia de dibujo 
de componentes. 


void updateUl() Llamado por UlManager cuando | 
cambia la apariencia. 


Crearemos un ejemplo con la clase JSplitPane. En este caso, añadimos los 
campos de texto a un panel divisor. Hacer esto es bastante fácil; basta con crear 
los campos de texto y un panel de separación, como hacemos a continuación: 

import 


import 
import 


java.awt.*; 
Jjavax.swing.*; 


java .awt .event.*; 


JE 


<APPLET 
CODE = splitpane-class 
WIDTH = 600 
HEIGHT = 200 > 
</APPLET> 


“Z 


public class splitpane extends JApplet implements ActionListener 


{ 


JButton jbuttonl, jbutton2, jbutton3; 

JTextField textl = new JTextField ("Texto 1"); 

JTextField text2 = new úTe-tField(-Text2"); 

JSplitPane jsplitpane = new JS ----P=r=“(JS-==“=P==”“., VERTI 
textl, text2); 


Ahora añadimos el nuevo panel de separación al panel de contenidos del 
applet, como sigue: 


public class splitpane extends JApplet implements ActionListener 
( 
JButton jbuttonl, jbutton2, jbutton3; 
JTextField textl = new JTextField("Text0 1"); 
JTextField text2 = new JTextField("Text0 2''); 
JSplitPane jsplitpane = new -SplitPane (JSplitPane.VERTI1ICAL-SpL1IT, 
textl, text2); 


public void hit () 
{ 


Container contentpane = getContentPane0; 


él starie E 


Figura 15.6. Creación de un panel de separación. 


Eso es todo. El resultado de este código se muestra en la figura 15.6. A3 
partir de ahora, el usuario puede ajustar el divisor entre los campos de texto 
mostrando una cantidad mayor o menor de cada uno según sea necesario. El 
panel de separación gestionará la vista de cada campo de texto. Este ejemplo 
se encuentra en el archivo splitpane.java del CD. 


Paneles de separación expandibles con un clic 


"Examina el nuevo panel de separación que he puesto a mi programa": 
dice el programador novato. "Está bien", reconocemos, "pero ¿por qué no lo 
hace expandirse con un clic?". El PN replica, "¿Cómo?". 

Hacer que un panel de separación sea expandible con una pulsación de 
ratón añade pequeños botones de flecha a su separador, los cuales, cuando 
son pulsados, expedirán uno u otro de los paneles para que ocupe el panel de 
separación completo. Este es un mecanismo útil si queremos maximizar un 


componente en un panel de separación, debido a que los paneles de separa- 
ción no permiten la reducción de los componentes por debajo de un cierto 
mínimo. Podemos hacer que un panel de separación sea expandible con una 
pulsación con el método setOneTouchExpandable del panel de separación. 
Para mostrarle cómo funciona, añadiremos un botón al panel de separación 
del ejemplo del tema previo que, cuando se pulse, hará que el panel de se- 
paración se expanda con una pulsación. Para añadir ese botón, crearemos 
primero un nuevo panel y lo añadiremos al distribuidor del applet, como sigue: 


import Java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 
/ * 
<APPLET 
CODE = splitpane.class 
WIDTH = 600 
HEIGHT = 200 > 
</APPLET> 
*) 


public class splitpane extends JApplet implements ActionListener 
{ 
JButton jbuttonl; 
JTextField textl = new JTextField ("Text01"); 
JTextField text2 = new JTextField("Texto 2") ; 


JSplitPane jsplitpane = new JSplitPane (JSplitPane.VERTICAL-SPLIT, 
textl, text2); 


public void init() 

{ 
Container contentpane = getContentPane0; 
JPanel jpanel = new manelo; 


jbuttonl = new JButton ("Expandible con un clic"); 
jbuttonl.add-ctionListener (this); 
jpanel.add (jbuttonl); 


contentPane.add(jpanel, BorderLayout.500TE 


public void actionPerformed(ActionEvent e) 
I 
if(e.getSource() == jbuttonl) ( 
jsplitpane.eetOneTouchExpandable (true); 
1 


1 


La figura 15.7 muestra el resultado de este código. Cuando el usuario hace 
clic sobre el botón, aparecen dos flechas en el divisor del panel de separación, 
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como se muestra en la figura. Ahora, el panel de separación se expande con la 
pulsación; por ejemplo, cuando el usuario hace clic sobre la flecha superior, 
el campo de texto del pie se expande para llenar el panel de separación 
(exceptuando al divisor, que todavía es visible para que el usuario pueda 
hacer clic sobre la flecha inferior y restaurar la apariencia original). 


ppal Wa ipld pare dal 


Figura 15.7. Hacer un panel de separación expandible con una pulsación. 


Configuración de la orientación del panel de 
separación 


742 


"No, no, no", dice impaciente el gran jefe, "no queremos ningún divisor- 
horizontal en los paneles de separación. Queremos divisores verticales". 
"Bien", decimos, "podemos hacerlo. ¿Cuándo lo quiere?" "¿Estáhecho ya?", 
pregunta el gran jefe. 

Podemos configurar la orientación del divisor en un panel de separación' 
pasando al método setorientation la constante JSplitPane-HORIZONTAL- 
SPLIT o JSplitPane. VERTICAL-SPLIT. Añadiremos esta capacidad al ejem- 
plo del panel de separación del tema previo con un nuevo botón que permite 
al usuario especificar un divisor horizontal, como aparece a continuación: 

import java.awt.*; 


import javax.swing.*; 
import java.awt.event.*; 


jF 
<APPLET 
CODE = splitpane.class 
WIDTH = 600 
HEIGHT = 200 > 
</APPLET> 
"Z 


public class splitpane extends JApplet implements ActionListener 


JButton jbuttonl, jbutton2: 

JTextField textl = new JTextField("Textol"); 

JTextField text2 = new JTextField("Text02"); 

JSplitPane Jsplitpane = new JSplitPane(JSplitPane 
textl, text2); 


A e 


public void init() 

{ 
Container contentpane = getContentPane0; 
JPanel jpanel = new JPanelO0; 


jbuttonl = new JButton ("Expandiblecon un clic"); 
jbuttonl.addActionListener (this); 
Jpanel .add (jbutton1); 


jbutton2 = new JB-tton (“Divisiblkorizontalmente"); 
jbutton2.addActionListener (this); 
jpanel . add (jbutton2); 


public void actionPerformed (ActionEvent e) 


1 
if(e.getSource0 == jJbuttonl) ( 


jsplitpane.setOneTouchExpandable (true); 
1 


if(e.getSource() == jbutton2) ( 
jsplitpane.setOrientation (JSplitPane.HORIZONTAL-SPLIT); 


La figura 15.8 muestra el resultado de este código y el nuevo divisor 
orientado horizontalmente. 


Api Rara 


ppisi simien 


Figura 15.8. Configuración de la orientación de un panel de separación. 


Configuración del tamaño del divisor de un panel 
de separación 


Puede ajustar el tamaño del divisor que aparece en un panel de separación 
utilizando el método setDividerSize y pasándole la nueva anchura del divisor 
en puntos. Aquí tenemos un ejemplo en el que añadimos un botón al caso 
anterior. Cuando el usuario hace clic sobre este botón, obtiene la anchura 
actual del divisor con el método getDividerSize, le suma 10 puntos y utiliza 
el resultado como nueva anchura de divisor. Aquí tenemos el código: 


` x ka 

import Java.awt. 

import javax.swing.*; 
import jJava.awt.event.*; 


JE 
<APPLET 
CODE = splitpane.class 
WIDTH = 600 
HEIGHT = 200 > 
</APPLET> 
t7 


public class splitpane extends JApplet implements ActionListener 


I 
mutton jbuttonl, jbutton2, jbutton3; 

JTextField textl = new JTextField ("Text01"); 

JTextField text2 = new JTextField ("Text02"); 

~~xplit~gaitpane = new JS--=--=-Pror”(JSo-oo«Pror  VERTICZ 
textl, text2); 


public void hit () 

I 
Container contentpane = getContentPane0; 
JPanel jpanel = new JPanelO0; 


jbuttonl = new JButton ("Expandiblecon un clic"); 
jbuttonl.addActionListener (this); 
Jjpanel .add (jbutton1); 


jbutton2 = new JButton ("Divisible horizontalmente"); 
jbutton2.addActionListener (this); 
Jjpanel .add (jbutton2); 


jbutton3 = new JButton ("Incrementar el tamaño del divisor.); 
jbutton3.add-ctionListener (this); 
jpanel . add (jbutton3); 
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public void actionPerformed (ActionEvent e) 


{ 
if(e.getSource() == jbuttonl) { 


jsplitpane.setOneTouchExpandable (true); 


1 
if (e.getSource() == jbutton2) ( 
jsplitpane.setOrientation(JSplitPane.HORIZONTAL-SPL1T); 


1 

if(e.getSource() == jbutton3) ( 
jsplitpane.set-ividerSize(jsplit-ane.getDividerSiwe (H 10); 

1 


1 


La figura 15.9 muestra el resultado. Cuando el usuario hace clic sobre el 
botón para incrementar el tamaño del divisor, éste aumenta su tamaño cada 
vez en 10 puntos. 


[toi eri pd ps ilaia 


Figura 15.9. Configuración del tamaño de un divisor de un panel horizontal. 


Uso del gestor de distribución de cuadro 


"Tengo muchas herramientas de dibujo en mi programa", dice el progra- 
mador novato, "y quiero distribuirlas verticalmente en una columna alta. 
¿Alguna sugerencia?" "Claro", decimos, "utilice un distribuidor de cuadro". 
"Bien", dice el PN, pero "jcómo?" 

La Swing introduce dos nuevas distribuciones: la distribución del cuadro 
y la distribución superpuesta. Examinaremos en este tema la distribución de 
cuadro y posteriormente la distribución superpuesta en este capítulo. Puede 
utilizar distribuciones de cuadro para situar componentes a lo largo del eje x 
en una fila o a lo largo del eje y en una columna. Aquí tiene el árbol de 
herencia para la clase BoxLayout, que soporta la distribución de cuadro: 


=j 
Fi 


La tabla 15.7 muestra los campos de la clase BoxLayout, la tabla 15.8 
muestra su constructor y la tabla 15.9 sus métodos. 


Tabla 15.7. Campos de la clase BoxLayout. 


static int X-AXIS 


static int Y-AXIS 


Descripción 
Indicaque los componentes deberían | 
distribuirse de izquierda a derecha. 


Indicaque los componentesdeberían 
distribuirse de arriba a abajo. 


Tabla 15.8. El constructor de la clase BoxLayout. 


Constructor 


Descripción 


BoxLayout(Container target, int axis) Construye un gestor de distribución 
de cuadro. 


Tabla 15.9. Métodos de la clase BoxLayout. 


Método 


Descripción 


voidaddLayoutComponent(ComponentObtiene el alineamiento a lo largo 


comp, Object constraints) 


void addLayoutComponent(String na- 


me, Component comp) 


float getLayoutAlignmentX(Container 
target) 


float getLayoutAlignmentY(Container 
target) 


Dimension maximumLayoutSize(Con- 


tainer target) 


Dimension minimumLayoutSize(Con- 
tainer target) 


del eje x del contenedor. 


Obtiene el alineamiento a lo largo 
del eje y del contenedor. 


Indica el cambio de un hijo en su 
información de distribución. 


Llamado por el AWTcuando el con- 
tenedorindicado necesita una nue- 
va distribución. 


Obtiene las dimensiones máximas 
que puede utilizar el contenedor 
destino para distribuir los compo- 
nentes que contiene. 


Obtiene las dimensiones mínimas 
necesitadas para distribuir loscom- 
ponentes del contenedor destino 
indicado. 


Método Descripción 


Dimension preferredLayoutSize(Con- Obtiene las dimensiones preferidas 

tainer target) para esta distribución, dados los 
componentes en el contenedor 
destino indicado. 


Aquí tenemos un ejemplo en el que distribuimos tres paneles usando una 
distribución de cuadro (dos verticalmente y uno horizontalmente) y añadimos 
cuatro campos de texto a cada distribución. Esto supone simplemente utilizar 
un nuevo gestor de distribución de cuadro en cada panel, como sigue: 


import java.awt.*; 
import javax.swing.*; 


EA 
<APPLET 
CODE = boxlayout.class 
WIDTH = 250 
HEIGHT = 200 > 
</APPLET> 
*) 


public class boxlayout extends JApplet 


public void inito0 


{ 


Container contentpane = getContentPane0; 
JPanel jpanell, jpanel2, jpanel3; 


jpanell = new JPaneloO; 
jpanel2 = new JPanelO; 
jpanel3 = new JPanel0; 


jpansli.setLayout {new BoxLayont [fpanall, DoxLayout.Y_AXIS]]; 
ipánal3.sarLayout (new BosLayout ([fpañell, BonLayout.E_AXIE] Í; 
ipanal3.satLayout (now BorLayout (ipanoli, Bonlayout.T_AXIS] j} 


ina | aE 
AS Text a" 
pane Text 
par ë axi j" 
F add new TTextrieldi"Toaxe 1 
Dp 3 add new axtF ja Text 
panela. add (new ITeztFieldi" Texto 3* 
parola.add [now TTartFialr Toxt à 
pät a | ria »tF ie A 


La figura 15.10 muestra el resultado, donde puede verlas tres distribucio- 
nes de cuadro. Este ejemplo fue relativamente fácil de crear y ejecutar. 
Aparece en el archivo boxlayout.java del CD. 

No obstante, existe una mayor potencia disponible en la distribución de 
cuadro; examinaremos la clase Box en el siguiente tema. 


Figura 15.10. Creación de distribuciones de cuadro. 


Uso de la clase Box 


"Las distribuciones de cuadro están bien", dice el programador novato, 
"pero necesitó más control. Por ejemplo, quiero espaciar los controles en una 
fila, pero no puedo hacerlo con una distribución de cuadro". "Seguro que 
puede", contesta, "si utiliza la clase Box". "¿Cómo es eso?", pregunta el PN. 

La clase Box utiliza una distribución de cuadro que añade métodos que 
nos permiten trabajar con estas construcciones para extender esa distribución: 


e Glue. Expande hasta completar la región vacía entre componentes. Se 
puede utilizar g/ue para espaciar los componentes de forma uniforme. 


e Struts. Son las distancias horizontales o verticales que especificamos y 
añadimos a la distribución para espaciar los componentes como desee- 
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mos. Los struts están fijos en una dimensión y rellenan la otra dimen- 


sión según sea necesario. 


e Áreas rigidas. Son áreas rectangulares que no cambian de tamaño por sí 


mismas. 


Aquí tenemos el diagrama de herencia para la clase Box: 


java.lang.0bject 


+-java.awt . Component 


+-java.awt.Container 
| 


Encontrará los campos de la clase Box en la tabla 15.10, sus constructores 
en la tabla 15.11 y sus métodos en la tabla 15.1 2. 


Campo 


protected AccessibleContext acce- 
ssibleContext 


Tabla 15.10. El campo de la clase Box. 


Descripción 


El AccessibleContext. 


Tabla 15.11. El constructor de la clase Box. 


Constructor 


| Box(int axis) 


Descripción 


Construye un cuadro. 


Tabla 15.12. Métodos de la clase Box. 


Método Descripción 


static Component createGlue0 


static Box createHorizontalBox() 


static Component create Horizontal- 
Glue() 


static Component createHorizontal- 
Strut(int width) 


static Component createRigidArea 
(Dimension d) 


Construye un componente pegado. 


Construye un cuadro que visualiza 
sus componentes de izquierda a 
derecha. 


Construye un componente pegado 
horizontal. 


Construye una dura liga invisible de 
anchura fija. 


Construye un componente invisible 
que siempre tiene eltamaño indicado. 
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Descripción 


static Box create VerticalBox() Construye un cuadro que visualiza 
sus componentes de arriba a abajo. 


static Component create VerticalGlue() Construye un componente pegado 
vertical. 


static Component createvertical- Construye una ligadura invisible de 
Strut(int height) altura fija. 


AccessibleContext getAccessible- Obtiene el AccessibleContext. 
Contexto 


void setLayout(LayoutManager |) Genera un AWTError (un objeto Box 
únicamente puede utilizar un BoxLa- 
yout). 


Aquí tenemos un ejemplo de uso de la clase Box. En este caso, utilizamos 
los métodos createGlue, createRigidArea, createHorizontalStrut y 
createverticalstrut de la clase Box para crear áreas rígidas, pegadas, e irregu- 
lares. Estos componente se pueden añadir a las distribuciones de cuadro, para 
crear seis paneles, cada uno con una distribución de cuadro y añadir áreas de 
texto a los paneles utilizando áreas pegadas, irregulares y rígidas para mos- 
trar cómo funciona todo esto. Aquí tenemos el código: 

import Java.awt.*; 

import javax.swing.*; 


import javax.swing.border.*; 


/* 


<APPLET 
CODE = box.class 
WIDTH = 450 
HEIGHT = 400 > 
</APPLET> 
*7 


public class box extends JApplet 
1 
public void hito 
I 
Container contentpane = getContentPane0; 
contentPane.setLayout (new FlowLayout ()); 


J'Panel jpanell = new JPaneloO; 
jpanell.setBorder (BorderFactory.create-itledBord-- 
(BorderFactory.createEtchedBorder”), "Pegada")); 
jpanell.eet-ayout (new -ox-ayout (jpaneiiBox-ay0ut.x-—-AXIS)); 
jpanell .add (Box. createGlue ()); 
jpanell.add (new JTextField("Text0 1")); 


jpanali. add Bor created 

jpaneli. addins» ITartFisld("Tarto 3"), 
panali: addi Bpr. preat eglas i} jF 
jpanali.add ase ITentifTield("Tento 3*)); 
ipanell add inoz. crostaclus ii; 

cntent Pana. add ]panell!ls 


JPanel jpanel2 = new JPanelO; 
jpanel2.setBorder (BorderFactory.createTitledBorder 

(BorderPactory.create-tched8order-),"Ajustada-”)); 

jpanel2.setLayout (ne-BoxLayout (jpanel2, BOxLayout.X-AXIS)); 

jpanell.add (new JTextField ("Texto 1")); 

jpanel2.add (Box. createHorizontalStrut (20)); 

jpanel2.add (new JTextField("Text0 2")); 

jpanel2.add (-“ox.createHorizontalStrut (20)); 

jpanel2.add (new JTextField("Texto 3")); 

content-ane . add (jpanel2); 


JPanel jpanel3 = new JPaneloO; 
jpaneld.pnetBordesciBorderfactory.oreateTitlednorder 

iBorcderFactory.orsatsEFtobedbscder(), "Rigida" )}i 

panela. set Layout {new BonLayout (Jpanel2, BomLaycut. X_AXIZH} |I] 

ipanal3. add iBor. crsaterigldires (ne Dimeneion(i, 4011); 

jpaneld add iner TTextriald(*"Texto 11]; 

jpane1) add (Bon cosatoRigidhres (now Dimenslon(10, 401114 

jpasall.addines FTemtField("Taxto 237115 

ipanel. add iBox.comateñigidires (ner Dissnñica (10, 4011); 

ijpanesli. add (new FTextFleld(*Taxzto 31]; 

contestas. add idpanel3 ) p 


JPanel jpanel4 = new JPaneloO; 
jpanel4.setBorder (BorderFactory.createTitledBorder 

(“-orderFactory.createEtche-order('Pegada”)); 

jpanel 4. setLayout (new BoxLayout (jpanel4, BoxLay0ut .Y-MIS)); 

jpanel 4 . add (Box. createGlue ()); 

jpanell.add (new JTextField("Text01")); 

jpanel 4. add (Box .createGlueo) ; 

jpanell.add (new JTextField ("Texto 2")); 

jpanel4 . add (Box. createGlue ()); 

jpanel4.add (new JTextField("Texto 3") ); 

Jjganel4.add (Box. createGlueo) ; 

contentPane. add (jpanel4) ; 


JPanel jpanel5 = new JPaneloO; 
jpanel5.setBorder (BorderPactory.create-itledBorder 

(“order-actory.createEtchedBorder-“)Pegada”)); 

jpanel5.setLayout (new -ox-ayout (jpanel5yox-w-ayout.-“—-MIS)); 

jpanelS.add (new JTextFieldí"Texto 1")); 

jpanel5 . add (Box. createVerticalStmt (30)); 

jpanelS.add (new JTextField("Text0 2")); 

jpanel5.add (Box .createVerticalStmt (30)); 

jpanelS.add (new JTextField("Text0 3")); 

contentPane. add (jpanel5) ; 


JPanel jpanelé6 = new JPanel(): 
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jpanel6.setBorder (BorderPactory.createTitledBorder 
(BorderFactory.createEtchedBorder (), "Rígida")); 


jpanel6.setLayout (new “oxLayout (jpanel6,BoxLayout .Y-MIS)); 


jpanel 6. add (Box. createRigidArea (new Dimension (40, 60))); 
jpanel6.add (new JTextField("Texto 1")); 
jpaneló.add (Box.createRigidArea (new Dimension (40, 
jpanel6.add(new JTextPield ("Texto 2")); 
jpanel6.add (Box.createRigidArea (new Dimension(40, 60))); 
jpanel6.add (new JTextField (*Texto 3")); 

contentPane .add (jpanel 6) ; 


60))); 


1 


La figura 15.11 muestra el resultado de este código. Como puede ver, el 
uso de la clase Box es una forma sencilla de extender las distribuciones de 


cuadro y nos permite personalizar el espacio entre los componentes. Este 
ejemplo se encuentra en el archivo box.java del CD. 


Figura 15.11. Uso de la clase Box. 


Uso del gestor de distribución de superposición 


"Mi programa está bastante desordenado", dice el programador novato. ' 
"¿Existe una forma sencilla para superponer los controles?" "¿Estáseguro de 
que lo quiere hacer así?", preguntamos. "Seguro", dice el PN. "Bien", deci- 


mos", "puede eliminar el gestor de distribución y localizar los controles 
mismos, o puede utilizar el gestor de superposición". "¿Existe un gestor de 
superposición?", pregunta el PN. "¡Dígame más!". 

Puede utilizar el gestor de superposición para superponer componentes en 
la Swing. El gestor de distribución está soportado por la clase OverlayLayout. 
Aquí tiene el diagrama de herencia para esta clase: 


java.lang.0bject 


La tabla 15.13 muestra el constructor para esta clase y la tabla 15.14 
muestra sus métodos. 


Tabla 15.13. El constructor de la clase OverlayLayout. 


Constructor 


Descripción 


OverlayLayout(Container target) 


Construye un gestor de distribución 
de superposición. 


Tabla 15.14. Métodos de la clase OverlayLayout. 


Método Descripción 


void addLayoutComponent(Compo- 
nent cornp, Object constraints) 


void addLayoutComponent(Stringna- 
me, Component cornp) 


float getLayoutAlignmentX(Container 
target) 


float getLayoutAlignmentY (Container 
target) 


void invalidateLayout(Container tar- 
get) 


void layoutContainer(Container tar- 
9et) 


Dirnension maximumLayoutSize 
(Container target) 


Añade el componente indicado a la 
distribución. 

Añade el componente indicado a la 
distribución. 

Obtiene la alineación a lo largo del 
eje x para el contenedor. 


Obtiene la alineación a lo largo del 
eje y para el contenedor. 


Indica que un hijo ha cambiado su 
informaciónrelativa a ladistribución, 
lo que produce que cualquier 
operación de caché se vuelque. 


Llama al AWT cuando el contenedor 
indicado necesita una nueva distri- 
bución. 
Obtiene las dimensiones máximas 
necesariasparadistribuirloscompo- 
nentes. 


DEE] 


Descripción 


Dimension minimumL ayoutSize Obtiene las dimensiones mínimas 

(Container target) necesarias para distribuirlos compo- 
nentes. 

Dimension preferredLayoutSize Obtiene lasdimensiones preferentes 

(Container target) para esta distribución dados sus 
componentes. 

void removeLayoutComponent Elimina el componente indicado a 

(Componentcomp) partir de su distribución. 


Aquí vemos cómo utilizar la distribución de superposición: En esta clase 
de distribución, añadimos componentes a un contenedor para que sus puntos 
de alineamiento estén en la misma posición. Cada uno de estos componentes 
también tiene unos atributos de alineamiento entre 0.0 y 1.0, que podemos 
asignar con los métodos setAlignmentX y setAlignmentY (el valor predeter- 
minado es 0.5). Éstos especifican dónde está el punto de alineamiento en 
cada dimensión. Por ejemplo, un atributo de alineamiento de 0.5 hace refe- 
rencia al centro de un componente en la dirección x. 

Una vez asignados el tamaño mínimo, máximo y preferido de los compo- 
nentes, el gestor de distribución de superposición intenta cambiar el tamaño 
de los componentes para que sus puntos de alineamiento se superpongan y 
procura mantener esa superposición. Si es posible, incluso aunque el conte- 
nedor cambie de tamaño. 

Vamos a examinar un ejemplo para que sea más claro. En este caso, 
superponemos los campos de texto, especificando sus tamaños mínimo, máxi- 
mo y preferido y asignando sus puntos de alineamiento para que un compo- 
nente aparezca en la esquina superior izquierda y el otro en la inferior derecha. 
Aquí tenemos el código: 


import java.awt.*; 
import javax.swing.*; 


/* 
iAPPLET 
CODE = overlay.class 
WIDTH = 200 
HEIGHT = 200 > 
</APPLET> 
g 


public class overlay extends JApplet 
( 
public void init () 


{ 


Container contentpane = getContentPane0; 


JPanel jpanel = new JPanelO0; 
jpanel . setLayout (new OverlayLayout (jpanel)); 
jpanel . set-ackground (Color .white); 
jpanel.setBorder (BorderFactory.create-itled-order 
(“order-actory.createEtchedBorder-)'Superpuestam)); 
JTextPield textl = new JTextField("Texto 1"); 
JTextPield text2 = new JTextField("Texto 2"); 
textl.setMini-Size (new Dimension(30, 30)); 
text2.setMinimumSize (new Dimension(30, 30)); 
textl.setPreferredSize (new Dimension(100, 100)); 
text2.-etPreferredSize (new Dimension(100, 100)); 
textl.setMaximumSize (new Dimension(120, 120)); 
text2.setMaximumSize (new Dimension (120, 120)); 


Eaxti. satilignmantE{0: 3f}7 
cextcl.setAligomentTió0. ZË} p 


text. tetAligimantri|5. 8f} r 
textI.setAlignmantY|0.8f}; 


ORLEN PANE. ATL POLE (mw Fio0eLafpcoucisi: 


La figura 15.12 muestra el resultado, donde puede ver los dos campos de 
texto superpuestos. Este ejemplo es un éxito y lo encontrará en el archivo 
overlay.java del CD. 


MA iron venn eE ARE] 


Apenas a 


Appel started 


Figura 15.12. Uso de un gestor de distribución de superposición. 
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M swing: menús 


y barras 


de herramientas 


Menús 


En este capítulo, trataremos dos de los más importantes componentes de la 
Sweing: menús y barras de herramientas. Ambos componentes son familiares 
para todos los usuarios IU y veremos cómo funcionan en la Swing. Examina- 
remos primero una breve descripción de lo que la Swing ofrece. 


Los menús de la Swing proporcionan algunas mejoras sustanciales sobre 
los menús AWT, como la habilidad para visualizar imágenes, asignar la 
apariencia de un elemento de menú y, especialmente, la habilidad para 
visualizar menús en ventanas de applet. Los menús de Swing quedan soporta- 
dos por las clases JMenuBar, JMenu y JMenultem, que soportan barras de 
menú, menús y elementos de menús, respectivamente. Como en la AWT, los 
menús de la Swing se crean utilizando botones entre bastidores, para que se 
puedan usar receptores de acción con ellos. 

En este capítulo, examinaremos lo que ofrecen los menús de la Swing, 
incluyendo la creación básica de menús, adición de imágenes a menús, crea- 
ción de menús de casillas de verificación y de botones de activación y 


submenús, adición de controles, botones de menús, creación de mnemónicos, 
aceleradores de menús y mucho más. También examinaremos la creación de 
menús emergentes. Los menús de la Swing son más complejos y potentes que 
sus equivalentes en la AWT, como veremos a continuación. 


Barras de herramientas 


Las barras de herramientas son controles IU populares, y son nuevos en la 
Swing. Como los menús, las barras de herramientas'se crean utilizando boto- 
nes en la Swing. Las barras de herramientas proporcionan una barra de 
botones que se pueden pulsar como los elementos de menús. De hecho, las 
barras de herramientas y los menús están íntimamente relacionados; habitual- 
mente se añadirá un botón a las barras de herramientas que representen 
elementos comunes de menús para evitar al usuario la molestia de abrir un 
menú. 

Examinaremos las barras de herramientas de la Swing, que están soporta- 
das por la clase JToolBar, incluyendo la adición de imágenes a botones de 
barras de herramientas, permitir al usuario alinear la barra de herramientas en 
cualquier borde de una ventana y la adición a las barras de herramientas de 
otros controles como cuadros combinados. 

Esto es suficiente para resumir el capítulo. Como puede ver, habrá mucho 
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mas. 


Crear una barra de menús 


El programador novato aparece y dice, "El gran jefe dice que necesito 
añadir un sistema de menús a mi programa. ¿Cómo diablos puedo hacerlo?" 
"Con tres componentes", decimos, "barras de menú, menús y elementos de 
menús. Pida un café y comenzaremos con las barras de menús". "Bien", dice 
el PN. 

Para añadir un sistema de menús a un programa Swing, tendremos que 
crear primero una barra de menús, utilizando la clase JMenuBar. Puede 
añadir una barra de menús al applet o marcos de ventana con el método 
setJMenuBar. Aquí tiene el diagrama de herencia para la clase JMenuBar: 


La tabla 16.1 muestra los constructores de JMenuBar y la tabla 16.2 sus 
métodos. 


Tabla 16.1. El constructor de la clase JMenuBar. 


Constructor Descripción 


JMenuBar() Crea una nueva barra de menú. 


Tabla 16.2. Métodos de la clase JMenuBar. 


Metodo Descripción 

JMenu add(JMenu c) Añade el menú indicado al final de la 
barra de menú. 

void addNotify() Sobrescribe JComponent. addNotify () 


para registrar esta barra de menú. 


AccessibleContext getAccessible  Obtieneel AccessibleContextasociado 


| Contexto con este JComponent. 

Component getComponent() Implementado paraser un Component. 

Component getcomponent- Obtiene el componente en el índice in- 

Atindex(int i) dicado. 

int getcomponentindex Obtiene el índice del componente indi- 

(Component c) cado. 

JMenu getHelpMenu() Obtiene el menú de ayuda para la 
barra de menú. 

Insets getMargin() Obtiene el margen entre el borde de la 
barra de menú y sus menús. 

JMenu getMenu(int index) Obtieneel menúen la posiciónindicada | 
en la barra de menú. 

int getMenuCount() Obtiene el número de elementos en la 
barra de menú. 

SingleSalecton Moda! Obtiene el modelo de objetos que ma- 

galSelecttoónModal() neja las selecciones simples. 


MenuElement[] geiSubElements[) Devuelve los menús en esta barra de 
menú. 


Método 


MenuBarUl getUl() 
String getUlClassID() 


boolean isBorderPainted() 


boolean isManagingFocus() 


boolean isSelected() 


void menuSelectionChanged 
(boolean isIncluded) 


protected void paintBorder 
(Graphics g) 
protected String paramString() 


void processKeyEvent 
(KeyEvente, MenuElement[] 
path, MenuSelectionManager 
manager) 


void processMouseEvent (Mouse 
Event event, MenuElement[] path, 
MenusSelectionManagermanager) 


void removeNotify() 


void setBorderPainted(boolean S) 


void setHelpMenu(JMenu menu) 
void setMargin(1nsets margin) 
void setSelected(Componentsel) 


void setSelectionModel 
(SinaleSelectionModelmodel) 


Descripción 


Obtiene la lUactual de la barra de menú. | 


Obtiene el nombre de la clase de apa- 
rienciaque renderizaeste componente. 


Devuelvetrue si elborde de la barrade | 
menú debe pintarse. 


Devuelve true para indicar que este 
componente procesa los eventos de 
foco internamente. 


Devuelve true si la barra de menú 
tiene un componente seleccionado. 


Implementado para ser MenuElement 
pero actualmente no hace nada. 


Pinta el borde de la barra de menú. 


Obtieneunarepresentaciónde cadena 
de esta JMenuBar. 


Implementado para ser MenuElement 
pero no hace nada. 


Implementado para ser MenuElement 
pero no hace nada. 


Sobreescribe JComponent.removeNo- 
tify para eliminar la barra de menú del 
registro. 


Indica si el borde debería pintarse. 


Asigna el camino de ayuda que aparece 
cuando el usuario seleccionala opción 
Ayuda en la barra de menú. 


Asigna el margen entre el borde de la 
barra de menú y sus menús. | 


Asigna el componente seleccionado. 


Asigna el modelo de objetos para pro- 
cesar selecciones simples. 


Haremos funcionar JMenuBar a lo largo de los próximos temas mientras 
creamos un sistema de menús básico. El siguiente paso es crear los menús 
para añadir a la barra de menús y lo haremos en el tema siguiente. 


Crear un menú 


El programador novato vuelve y dice, "He creado una barra de menús, 
pero no aparece nada en ella; ¿qué sucede?". Sonreímos y decimos, "Tiene 
que añadir los menús explícitamente". "Ah", dice el PN, "muéstreme ahora 
cómo funciona”. 

Creamos los menús de una barra de menús con la clase JMenu. Aquí tiene 
el diagrama de herencia para esa clase (observe que JMenu es realmente una 
subclase de JMenultem, debido a que JMenultem, que a su vez subclasifica a 
AbstractButton, puede responder a clics de ratón): 

java. Lang. Uee 


Java. awt Component 


=javyaš. mina. porn E 
*—J0VAA..5wi0g.-AbaTraccButcon 
D AVAR wing. -JHremiitem 
1470.51. Jarna 


La tabla 16.3 muestra el campo de la clase JMenu, la tabla 16.4 muestra 
sus constructores y la tabla 16.5 sus métodos. 


Tabla 16.3. El campo de la clase JMenu. 


Campo Descripción 


protected JMenu.WinListener El receptor de cierre de ventana emer- 
popupListener gente. 


Tabla 16.4. Constructores de la clase JMenu. 


Constructor a Descripción 
Jeria) Construye un nuevo JMenu. 
JMenu(String s} Construye un nuevo JMenu con la 


cadena como texto. 
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Constructor Descripción 


JMenu(String S, boolean b) Construye un nuevo JMenu con la 


cadena comotexto y especifica si tiene 
un menú roto, como indica el valor 
boolean. 


Tabla 16.5. Métodos de la clase JMenu. 


Método č  ć Descripción 


JMenultem add(Action a) Construye un nuevo elemento de menú 
añadido al objeto Action indicado y la 
añade al final de este menú. 


Component add(Component c) Añade un componente al final de este 
menú. 

JMenultem add(JMenu1tem Añade un elemento de menú al final de 

menultem) este menú. 

JMenultem add(String S) Construye un nuevo elemento de menú 


con el texto indicado y lo añade al final 
de este menú. 


void addMenuListener Añade un receptor para eventos de 

(MenuListener 9 menú. 

void addSeparatorO Añade un nuevo separador al final del 
menú. 

protected PropertyChange Creaunreceptorde cambios de acción. 


Listener createactionchange- 
Listener(JMenu1temb) 


protected JMenu.WinListener Crea un receptor de cierre de ventana. 

createWinListener(JPopupMenu p) 

void doClick(int pressTime) Realiza una acción de clic programá- 
ticamente. 


protected void fireMenuCanceled() Notifica a todos los receptores regis- 
trados para esta notificación que ha 
ocurrido este evento. 


protected void fireMenu- Notifica atodos los receptores registra- 
Deselectedo dos para esta notificación. 


protected void fireMenuSelected() Notifica a todos los receptores regis- 
trados para esta notificación. 


Método Descripción 


Accessiblecontext Obtiene el AccessibleContext. 
getAccessibleContext() 


Component getComponent() Devuelve el java.awt.Component 
utilizado para pintar este MenuElement. 


int getDelay() Obtiene el retraso sufrido antes de que 
se muestren o cierren los menús 
emergentes. 


JMenultem getltem(int pos) Obtiene el JMenultem en la posición 
indicada. 


int getltemCount() Obtiene el número de elementos de 
menú, incluyendo separadores. 


Component getMenu- Obtiene el componente que ocupa la 
Component(int n) posición n. 


int getMenuComponentCount() Obtiene el número de componentes del 
menú. 


Component|[] Obtiene una matriz con los componen- 


getiMenuComponents() tes de menú. 


JPopupMenu getPopupMenu() Obtiene el menú emergente asociado 
con este menú. 


MenuElement[]getSubElements() Obtiene la matriz que contiene los 
componentes submenús para este 
componente menú. 


String getUlClassiD() Obtiene la clase de apariencia que 
renderiza este componente. 


JMenultem insert(Action a, int pos) Inserta un nuevo elemento de menú 
añadido al objeto Action indicado en la 
posición nada. 


JMenultem insert Inserta el JMenuitem indicado en una 
| (JMenultem mi, int pos) posición dada. 
void insert(String s, int pos) Inserta un nuevo elemento de menú 
| con el texto indicado en una posición 
dada. 
void insertSeparator(int index) Inserta un separador en una posición 
indicada. 
boolean isMenuComponent Devuelvetrue sielcomponente indicado 
(Component c) existe en la jerarquía de submenús. 


Método 


Descripción 


boolean isPopupitenuWisiblej) 


boolean isSelected() 


boolean isTearOff() 
boolean isTopLevelMenu() 


void menuSelectionChanged 
(boolean isIncluded) 


protected String paramString() 


protected void processKey 
Event(KeyEvent e) 


void remove(Componentc) 


void remove(int pos) 


void remove(JMenultem item) 


void removeAll() 


void removeMenuListener 
(MenuListener 1) 


void setAccelerator 
(KeyStroke keystroke) 


void setDelay(int d) 


void setMenuLocation(int x, int y) 


void setModel(ButtonModel 
newModel) 


void setPopupMenuVisible 
(boolean b) 


Devuelve true si en la ventana de menú 
emergente es visible. 


Devuelve true si el menú está 
seleccionado en este momento 
(emergente). 


Devuelve true si el menú se puede | 
desactivar. 


Devuelve true si el menú es un menú | 
de primer nivel. 


Se llama cuando la selección de la ba- | 
rra de menú cambia. 


Obtiene una representación decadena | 
de este JMenu. 


Sobrescribe processKeyEvent para 
procesar eventos. 


Elimina el componente. 


Elimina el elemento de menú en la 
posición dada. 


Elimina el elemento de menú indicado. 


Elimina todos los elementos de menúa 
partir de este menú. 


Elimina un receptor para eventos de | 
menú. 


No definido para JMenu. 


Asigna el retraso sugerido antes de 
que se muestre o cierre un menú 
emergente. 


Asigna la localización del componente 
emergente. 


Asignael modelode datos para elbotón 
de menú. 


Asignala visibilidad de la porción emer- 
gente del menú. 


Método Descripción 


void setCelected(boolean b) Asigna el estado de selección del menú 
void updateUl() Llamado por UlFactory cuando cambia 
la apariencia. 


Cuando creamos los menús utilizando la clase JMenu, poblamos estos 
menús con elementos de menús (consulte el siguiente tema para ver los 
detalles). 


Crear un elemento de menú 


"Perfecto", dice el programador novato, "he creado algunos menús. ¿Cómo 
añado elementos de menú a estos menús?; ¿con la clase JMenultem? ". "Exacto", 
decimos. Los elementos reales en los menús de la Swing están soportados por la 
clase JMenultem. Aquí tiene el diagrama de herencia para esta clase: 


La tabla 16.6 muestra los constructores de la clase JMenultem y la tabla 
16.7 sus métodos. 


Tabla 16.6. Constructores de la clase JMenultem. 


Constructor Descripción 


JMenultemO Construye un JMenultem. 
JMenultem(Icon icon) Construye un JMenultem con un icono. 
JMenultem(String text) Construye un JMenultem con texto. 


JMenultem(String text, Icon icon) Construye un JMenultern con el texto 
proporcionado y un icono. 


JMenultem(String text, Construye un JMenultem con el texto y 
int ranemonic) mnemónicodeteclado proporcionados. 


EEE 


Tabla 16.7. Métodos de la clase JMenultern. 


Método 


void addMenuDragMouse 
Listener(MenuDragMouse 
Listener /) 


void addMenuKeyListener 
(MenuKeyListener 1 


protected void fireMenuDrag 
MouseDragged(MenuDragMouse 
Event event) 


protected void fireMenuDrag 
MouseEntered(MenuDragMouse 
Event event) 


protected void fireMenuDrag 
MouseExited(MenuDragMouse 
Event event) 


protected void fireMenuDrag 
MouseReleased(MenuDragMouse 
Event event) 


protected void fireMenuKey 
Pressed(MenuKeyEvent event) 


protected void fireMenuKey 
Released(MenuKeyEvent event) 


protected void fireMenuKey 
Typed(MenuKeyEvent event) 


KeyStroke getAccelerator() 
AccessibleContext 
getAccessibleContext() 


Component getComponent() 


MenuElement[] getSubElements() 


String getUlClassID() 


Descripción 


Añade un MenuDragMouseListener. 


Añadeun MenuKeyListeneral elemento 
de menú. 


Dispara el evento "ratón arrastrado". 


Dispara el evento "ratón entra". 


Dispara el evento "ratón sale". 


Dispara el evento "ratón suelto". 


Dispara el evento "tecla pulsada". 
Dispara el evento "tecla soltada". 
Dispara el evento "Introduce tecla". 


Obtiene el KeyStroke que sirve como 
acelerador para el elemento de menú. 


Obtiene el AccessibleContextasociado 
con este JComponent. 


Devuelve el java.awt.Component 
utilizado para pintar este objeto. 


Devuelve una matriz que contiene los 
componentes de submenú para este 
componente menú. 


Obtiene el nombre de la clase de | 
apariencia que renderiza este compo- 
nente. 


Método Descripción 


protected void init(String text, 
Icon icon) 


boolean isArmed() 


void menuSelectionChanged 
(boolean isIncluded) 


protected String paramString() 


void processKeyEvent 
(KeyEvent e, MenuElement[] 
path, MenuSelectionManager 
manager) 


void processMenuDragMouse 
Event(MenuDragMouseEvente) 


void processMenuKeyEvent 
(MenuKeyEvent e) 


void processMouseEvent 

| (MouseEvent e, MenuElement[] 
path, MenuSelectionManager 
manager) 


void removeMenuDragMouse 
Listener(MenuDragMouse 
Listener 1) 


void removeMenuKeyListener 
(MenuKeyListener 1) 


void setAccelerator 
(KeyStroke keystroke) 


void setArmed(boolean b) 
void setEnabled(boo1eanb) 


void setUl(MenultemU!I ui) 


void updateUl() 


Inicia el elemento de menú con el texto 
e icono indicados. 


Determina si el elemento de menú está 
armado. 


Llamada por MenusSelectionManager 
cuando cambia el estado de selección 
de MenuElement. 


Obtiene una representación de cadena 
de este JMenultem. 


Procesa un evento de tecla procedente 
del MenuSelectionManager. 


Maneja el arrastre del ratón en un me- 
nú. 


Maneja una pulsación de tecla en un 
menú. 


Procesa un evento de ratón procedente 
del MenuSelectionManager. 


Elimina un MenuDragMouseListener. 


Elimina un MenuKeyListener del ele- 
mento de menú. 


Asigna la combinación de teclas que 
invoca a los receptores de la acción del 
elemento de menú sin navegar por la 
jerarquía de menús. 


Identificacomo armadoal elemento menú. 
Habilitao inhabilitael elementode menú. 


Asigna el objeto apariencia que 
renderiza este componente. 


Llamada por UlFactory cuando cambia 
la apariencia. 


Como muestran las tablas 16.6 y 16.7, la clase JMenultem tiene mucho 
que ofrecer; por ejemplo, puede determinar si un elemento de menú esta 
"armado" (es decir, quedará seleccionado si el usuario suelta el botón del 
ratón) con los métodos isArmed y setArmed. 

Este tema y los dos anteriores han introducido las barras de menús, menús 
y elementos de menú en la Swing; conjuntaremos estos elementos en el 
siguiente tema para crear un sistema de menús básico. 


Crear un sistema de menús básico 


TES 


"He creado un objeto de barra de menús, objetos menús y objetos elemen- 
to de menú", dice el programador novato, "pero, ¿cómo diablos los uno?". 
"Siéntese y lo haremos", decimos. "No es difícil". 

Los tres temas anteriores han introducido las clases necesarias para crear 
menús en la programación Swing: JMenuBar, JMenu y JMenultem. Haremos 
funcionar estas clases en un ejemplo que visualiza dos menús, Archivo y 
Edición, en una barra de menús. Cuando el usuario hace clic sobre un ele- 
mento de menú, el código visualizará el elemento seleccionado en la barra de 
estado del applet. 

Vamos a comenzar creando una barra de menús con la clase JMenuBar. 
Después, crearemos el menú Archivo con la clase JMenu y los tres elementos 
de menú para ese menú: Nuevo, Abrir y Salir, utilizando la clase JMenultem: 


` . * 

import java.awt. 5 
import jJavax.swing.*; 
import jJava.awt.event.*; 


pe 
<APPLE 

CODE = menu.class 

WIDTH = 350 

HEIGHT = 280 > 
</APPLET> 

Ef 


public class menu extends JApplet implements ActionListener 
{ 
public void init () 


{ 
J'MenuBar jmenubar = new J'MenuBaro; 


JMenu jmenul = new J 'Menu ("Archivom) ; 

J'Menultem jmenuiteml new JMenultem("Nuevo-—.."). 
jmenuiteuú! = new men-Item(-Abrir..."), 
jmenuitem3 = new irMenu-tem(-“Salir"); 


Ahora, podemos añadir los tres elementos de menú al menú Archivo 
utilizando el método add de la clase JMenu. Con los elementos de menú se 
utilizan receptores de acción, por lo que proporcionaremos a cada elemento 
de menú un comando de acción y añadiremos un receptor de acción a cada 
elemento (observe que los separadores de menú se pueden añadir con el 
método addseparator): 


public void init O 


( 


JMenuBar jmenubar = new JMenuBaroO; 


JMenu jmenul = new JMenu Í"Archivo"); n 

JMenuItem jmenuiteml = new JMenultem("Nuevo... ), 
jmenuitem2 = new JMenultem("Abrir... ”) j 
jmenuitem3 = new JMenultem("Salir"); 


jm 1.00 ijmenuitemi ly 
añada (Jasnaltani)s 
{mansi .ađäfeparator i} r 

AA EE y 


{manail temni . satActilonl ommani l"“Halecciosó Muiavo") p 
jmscuitead.,petActionCcommand ("Seleccioná Abrir"); 


jssnuiltemi.addactionListener think 
jisanultel. addictiontistener this); 


Puede crear el menú Edición de la misma forma, proporcionándole tres 
elementos: Copiar, Pegar y Cortar: 


public void init () 


I 


JMenuBar jmenubar = new JMenuBar ();5; 


JMenu jmenul = new JMenu ("Archivon); 

JMenuItem jmenuiteml = new JMenultem ("Nuẹvo. yan des 
jmenuitem2 = new JMenultem("Abrir... ), 
jmenuitem3 = new JMenultem("Salirn); 


jmenuil -ajda ijnenuiteni |: 
ipeni . add i inenuitema j: 
jmenul .addseparator i] 


jpnenui.add(jmenuitend |: 


jmenuiteml.set-ctionCommand (" “eleccionMuevo"); 
jrnenuitem2.-et-ction-ommand ("-elecciAhbir"); 


jpneñulteml.addActionListenerithia); 


nenulten. addkhctionListener 


JMenu jmenu2 = new JMen-” (-Edición"); 

JMenultem jmenuiteml = new JMenultemimCortarn), 
jmenuitem5 = new ü'KenuItem ("Copiar"), 
jmenuitem6 = new JMenuItem ("Pegarn); 


jimena. add] jmanuitemá); 
Banul , add |jJmnanruitams ) j 
jmenna . adä]jpenruitaemt ] ; 


Jmenuitemi. patäctionrComand i"Sealsccionó Cortar”! 
jesruitemi. setAccionComand | "Selecciona Capilar" j; 
Iinéscuiteal,setActioncrmand |" SalaccionS Pagar"); 


manii tani .addActionLis tanar {thisj jį 
manal tans .iddActicanaLi stanar {this} j 
jmanai tans attActionListeanarithisi y 


Lo único que queda por hacer es utilizar el método add de la clase JMenuBar 
para añadir elementos de menú a la barra de menús y para añadir la barra de 
menú al applet con el método setJMenuBar: 


public void init () 


{ 


JMenuBar jmenubar = new JMenuBaroO; 


JMenu jmenul = new JMenu("Archivo"); 
JMenultem jmenuiteml = new JMenultem("Nueva.. 1, 
jmenuitem2 = new JMenultem("Abrir.. ") : 


jmenuitem3 = new JMenultern ("Salir"); 


jmenul.add (jmenuiteml); 
jmenul.add (jmenuitem2); 
jmenul.addSeparatorO; 

jmenul. add (jmenuitem3! ; 
jmenuiteml.setActionCommand (-'SeleccionÓóNuevo"); 
jmenuitem2.setActionCommand ("Selec-ionÓóAbrir"); 


JMenu jmenu2 = new --enu("Edición"); 

JMenultem jmenuitem4 = new JMenultem("Cortar"), 
jmenuitem5 = new JNenultem("Copiar"), 
jmenuitemó = new JMenuItem ("Pegar"); 


jrnenu2.add (jmenuitem4) ; 
jmenu2.add (jmenuitemS); 
jmenu2.add (jmenuitem6); 


jmenuitem4.~etAction~ommand ("Seleccionĝortar"): 


jmenuitem5.-etActionCO0--and("Sele-cidwbiar”); 
jmenuitem6.setActionCO0-d("Sele--iérgar"); 


imssubar. 00 | Jmenal p p 
jmenubar 90d (Jasa | 


sac Tec Bar | jmanubar t a 


Ahora mostramos el sistema de menús al usuario. Cuando el usuario hace 
clic sobre un elemento de menú, obtendremos el comando action del elemen- 
to y lo visualizaremos en la barra de estado del applet utilizando el método 
actionperformed. Aquí tiene el código: 


public void actionPerformed (ActionEvent e) 
I 


JMenultem jmenuitem = (JMenultem)e.getSourceo0; 


Esto fue todo lo necesario para crear un sistema de menús básico. Trabajar 
con menús en la Swing es parecido a trabajar con ellos en AWT, con la 
diferencia obvia de que los applet en AWT no pueden visualizar menús. El 
resultado de este código se muestra en la figura 16.1, donde vemos el sistema 
de menús en funcionamiento. Este ejemplo (archivo menu.java en el CD) 
funciona exactamente como fue diseñado. 


Eta Vease mera clara 


al 


Seleccionó Nuevo 


Figura 16.1. Un sistema de menús básico. 


Adición de imágenes a menús 


=j 
=j 
B3 


El coordinador de diseño estético dice, "Sus menús son pobres; ¿podría 
mejorar las cosas un poco?". "Bien", decimos, "puedo añadir imágenes". 
"iFantástico!", dice el CDE. "Le enviaré las imágenes que quiero utilizar; son 
sólo de 1.024 por 1.024 pixels". "Ah", decimos. 

Es sencillo añadir imágenes a menús en la programación Swing; basta con 
añadir un icono a la llamada al constructor adecuado. Aquí tiene cómo se 
realiza la adición de imágenes a cada elemento de menú en el ejemplo del 
tema anterior: 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


/* 
<APPLET 
CODE = menuimages.class 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
el 


public class menuimages extends JApplet implements ActionListener 
{ 


ImagrIcon icon = new ImageI~on (~item. jpg.) ; 


public void init0 


( 


JMenuBar jmenubar = new JMenuBarO; 


JMenu jmenul = new JMenu("Archivo"); 

JUenultem jmsnuiteml = new JMenultemímtJuevo., icon), 
jmenuitd = new JMen-Item(-Abrir...",_icon), 
jmenuitem3 = new JMenultem("Salirn, icon); 


jmenul . add [jaen dam 
jmenui add ljnenuitemi) y 
jpenul,addseparitos (ls 


jmenul. add [jmonuiteni) y 


jmenuiteml. setActionCommand ( "Seleccionó Nuevo"); 
jmenuitem2.setActionCommand ( "Sele-r“ionÁábrir") ž 


jmenuiteni .addActionListeneritihis] 
¡Eon At miistenerichis):; 
JMenu jmenu2 = new JMenu ("Edición"); 


JMenultem jmenuitem4 = new JMenultem("Cortarn, icon), 
jmenuitem5 = new JMenultem("Copiarn, icon), 
jmenuit-6 = new JMenultem("Pegarm, icon); 


jmen add | |mamutl tamni} ; 
jmenua addijmenuitemi )} ; 
jmenu add | jiem 


Lamb: 


jmenuitem4.setActiO0nCOmmand ("Sele--ionbortar"); 
jmenuitem5.setActi0nCOmmand ("Sele--ionbopiar"); 
jrnenuitem6.-etActionCommand ("SeleccionóPegar"); 


jaenoitend.atbdietionListenrer (this) 


jseñulcoems5, addhetionListener (chile): 


jmenultcomé.addictiontictoner (chia); 


imenubar, add | jmenul il: 
¡issmubar, dad [añ]; 


soc TMemuiBasr [ jmonibar |; 
public void actionPerformed (ActionEvent e) 
{ 


JMenuItem jmenuitem = (JMenultem)e.getSourceo; 


showStatus (imenuiten-.getáctioncomaand ii 1 


La figura 16.2 muestra el resultado. Como vemos, cada elemento de menú 
presenta ahora una imagen. 


Appii YPERIT Aena iar 


Seleccionó Nuevo 


Figura 16.2. Adición de imágenes a menús. 
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Crear elementos de menú de casillas 
de verificación 


El especialista de soporte a productos aparece y dice, "Los usuarios no 
están contentos con nuestro nuevo programa, especialmente el elemento de 
menú Hacer todo el texto invisible, debido a que nunca saben si esa opción 
está habilitada hasta que ya es demasiado tarde". "Bien", decimos, "incluire- 
mos una casilla verificación sobre el elemento para mostrar cuándo está 
activo". 

Los menús de Swing soportan elementos de menú de casillas de verifica- 
ción como lo hacían los menús AWT. Puede utilizar la clase 
JCheckBoxMenultern para crear elementos de menú de casilla de verifica- 
ción en la programación Swing. Aquí tiene el diagrama de herencia para esta 
clase: 


Pd 


La tabla 16.8 muestra los constructores para la clase JCheckBoxMenultern 
y la tabla 16.9 sus métodos. 


Tabla 16.8. Constructores de la clase JCheckBoxMenultern. 


Constructor Descripción 


JSheckBoxMenultemi() Construye un checkboxMenultem no 
seleccionado. 

JCheckBoxMenultem(Icon icon) Construye un checkboxMenultem no 
seleccionado inicialmente con un 
icono. 

JCheckBoxMenultem(String text) Construye un checkboxMenultem no 
seleccionado inicialmente con texto. 

JCheckBoxMenultem (String text, Construye un checkboxMenultem 

boolean b) con el texto y estado indicados. 


Constructor Descripción 


JCheckBoxMenultem(String text, 
Icon icon) 


JCheckBoxMenultem(String text, 
Icon icon, boolean b) 


Construye un checkboxMenultemno 
seleccionado inicialmente con el 
texto e icono indicados. 


Construye un checkboxMenultem 
con el estado, texto e icono indica- 
dos. 


Tabla 16.9. Métodos de la clase JCheckBoxMenultem. 


Metodo 


-AccessibleContext getAccessible- 
Contexto 


Object[] polSalectedObjects(] 


boolean getState() 


String getUlClassID() 


protected String paramString() 


void requestFocus() 


void setState(boo1eanb) 


Descripción 
Obtiene el AccessibleContext. 


Obtiene una matriz (longitud 1) que 
contiene laetiqueta delelemento de 
menú de la casilla de verificación. 


Obtiene el estado seleccionado del 
elemento. 


Obtiene el nombre de la clase de 
apariencia que renderiza éste com- 
ponente. 


Obtieneunacadenade este JCheck- 
BoxMenultem. 


SobreescribeJComponent.request- 
Focus() para impedir la pérdida del 
foco. 


Asigna el estado seleccionado del 
elemento. 


Vamos a examinar un ejemplo. En este caso, añadimos cuatro elementos 
de casillas de verificación a un menú utilizando la clase JCheckBoxMenultem. 
Aquí tiene cómo crear y añadir estos elementos a un menú (observe que los 
receptores de acción se pueden utilizar con elementos de menús de casillas de 


verificación): 
import java.awt.*; 
import javax.swing.*; 


import java.awt.event.*; 


TT5 


CODE = menucheckbox.class 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
*/ 


public class menucheckbox extends JApplet implements ActionListener 


{ 


ImageIcon icon = new Imagelcon ("item. jpg"); 


JCheckBoxMenuItem 
jcheckbomnenuitaml = new “-CheckBomenultem (“Eiement d, icon), 
jcheckboxmenuitem2 = new ~~heckBoxMenuItem ("Element2". icon), 
jcheckboxmenuitem3 e new “-CheckBoxMenultem("Elemento3, icon), 
jcheckboxmenuitem4 = new JCheckBoxMenultem ("Elemento 4. icon); 


public void initoO 


{ 


Container contentpane = getContentPane0; 


JWenuBar jmenubar = new JMenuBaro; 
JMenu jmenu = new JWenu("Elementos de menú de casilla de 
verificaciónm); 


Jckackbosma=ssiteal.addictlonListener(thisi y 
Jcheckbommsni temi. aðãkotionbistenearithis} p 
Icbeckbommanuiteail,addáActiontliataner(thla)i; 
Jebsckbosaasao land addet ionListenerithinsi r; 


Jman. add |jcohbechkbonmenaiteml) ; 
Jaani. add |Jjcbheckbomanai tami) j 
Jmeno. add |jcheckbonmamnai tem ) ; 
jasnu. add | jobeokbomenral tami) ; 


jmenubar .add (jnmnu) 5 
setJWenuBar (jmenubar) 5 


Cuando el usuario hace clic sobre un elemento de menú de casilla de 
verificación, mostramos el estado de los cuatro elementos, como sigue: 


public void actionPerformed (ActionEvent e) 


{ 
showStatus (~Elemento1: = + jcheckboxmenuiteml.getState0 + 
" Elemento 2: = + jcheckboxmenuitd.getState0 + 
" 


Elemento 3: = + ¡checkboxmenuitd.getState0 + 
= Elemento 4: = + jcheckboxmenuitem4.getStateo) ; 


1 


Es todo lo que hace falta. La figura 16.3 muestra el resultado de este 
código. Como muestra la figura, las casillas de verificación aparecen como 


deberían en el menú. Este ejemplo se encuentra en el archivo 
menucheckbox.java del CD. 
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Figura 16.3. Creación de elementos de menú de casilla de verificación. 


Crear menús de botones de activación 


"Bien", dice el programador novato, "conozco la forma de crear elementos 
de menús de casilla de verificación con la clase JCheckBoxMenultem. Pero, 
¿qué sucede con los botones de activación? ¿No tenemos que añadir elemen- 
tos de casillas de verificación a un grupo?". "Casi es correcto", decimos. "De 
hecho, añadimos objetos JRadioButtonMenultem a un grupo". Utilizamos la 
clase JRadioButtonMenultem para crear elementos de menú de botones de 
activación en la Swing. Aquí tiene el diagrama de herencia para esta clase: 


java. lang. Objact 


ii avárz. sl. DRAadioButctonMenuliten 


La tabla 16.10 muestra los constructores de la clase JRadioButtonMenultem 
y la tabla 16.11 sus métodos. 


FB 


Tabla 16.10. Constructores de la clase JRadioButtonMenultem. 


Constructor 


JRadioButtonMeanultem() 
JRadioButtonMenultem(Icon icon) 


JRadioButtonMenultem(Icon icon, 
boolean selected) 


JRadioButtonMenultem(Stringtext) 


JRadioButtonMenultem(Stringtext, 
boolean b) 


JRadioButtonMenultem(String text, 
Icon icon) 


JRadioButtonMenultem(String text, 
Icon icon, boolean selected) 


Descripción 


Construye un JRadioButtonMenu- 
ltem. 


Construye un JRadioButtonMenu- 
Item con un icono. 


Construye un JRadioButtonMenu- 
Item con el estado de selección e 
imagen indicados, pero sin texto. 


Construye un JRadioButtonMenu- 
Item con texto. 


Construye un elemento de menú de 
botón de activación con el texto 
indicado y el estado de selección. 


Construye un JRadioButtonMenu- 
Item con el texto e icono indicados. 


Construye un elemento de menú de 
botón de activación que tiene texto, 
imagen de icono y estado de se- 
lección indicados. 
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Tabla 16.11. Métodos de la clase JRadioButtonMenultern. 


Método 


AccessibleContext getAccessible- 
Contexto 


String getUlClassID() 


protected String paramStringO 


void requestFocus() 


Descripción 


Obtiene el AccessibleContext. 


Obtiene el nombre de la clase de 
apariencia que renderiza este com- 
ponente. 


Obtiene una representación de 
cadena de este JRadioButtonMenu- 
Item. 


SobrescribeComponent.requestFo- 
cus() para no perder el foco. 


Vamos a examinar un ejemplo. En este caso, añadimos cuatro botones de 
activación aun menú y también un receptor de elementos para indicar cuándo 
está seleccionado o deseleccionado cada botón de activación. Aquí tiene la 


apariencia del código: 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


JE 
i¡APPLET 
CODE = menuradiobutton.clacc 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
7 


public class menuradiobutton extends JApplet implements ItemListener 


I 


ImageIcon icon = new ImageIcon ("item. jpg"); 


JRadioButtoaMenuItem 
jradiobuttonmenuiteml = new JRadioButtonMenu-tem(-Elementóm, 


icon), 
jradiobuttonmenuitd = new JRadioB-ttonMenultem(-Element2" 
icon), 
jradiobuttonmenuitem3 = new JRadioB-ttonMenultem (-Elementód". 
icon), 
jradíobuttonmenuitem4 = new JRadioB~ttoaMenuItem(~Elem@nto", 
icon) 
public void hit () 
{ 
Container contentpane = getContentPane0; 
JMenuBar jmenubar = new JMenuBaroO; 
menu jmenu = new JMenu ("Elementos de menú de botón de 
activaciónw); 


{mazs ada ]radlobatromssculteal); 
jmena . add ijradiobutronseruitena); 
imena. addi {]radicbattonmnanmii temni] ; 
jmenu. addi jradiobuttonmmanuitemnä] j 


ButtonGroup group = new ButtonGroup (); 
group.add (jradiobuttonmenuiteml); 
group.add (jradiobuttonmenuitem2); 
group .add (jradiobuttonmenuitem3) ; 

group .add (jradiobuttonmenuitem4) ; 


Jrādiobittonmaniitamni addItamLiatonerithis) 
jraliocobuttonmanaiten? addItamListanerithisi; 
Jraäicbuttonmanasiteni ,aidItemListenerithimi i 
jraficbuttonmansit end  addltemlidateneritbia)l; 


public void itemStateChanged (1temEvent e) 


JHenultem jmenuitem = (JMenultem) e.getSource (); 
String itemtext = jmenuitem-getText() 5 


if(e.getStateChange() == ltemEvent . SELECTED) 
itemtext += =" seleccionado ; 

else 
itemtext += m deseleccionado"; 


aboweitatos(itentec ) j 


La figura 16.4 muestra el resultado de este código, donde se muestra el 
funcionamiento en el menú de los botones de activación. Cuando el usuario 
hace clic sobre un botón de activación, este applet indica cuál se seleccionó 
en la barra de estado. Este ejemplo (archivo menuradiobutton.java en el CD) 
es un éxito. 


MEND ITEN =— | 
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Figura 16.4. Creación de elementos de menú de botones de activación. 


Crear submenús 


"Mis menús son muy grandes", dice el programador novato. "Quiero per- 
mitir al usuario seleccionar el color de dibujo en mi programa mediante 
elementos de menú, pero todos los colores están hacinando a los otros ele- 
mentos del menú". "Debería probar a poner todos los colores en un submenú", 
decimos. "¿Cuántos colores quiere mostrar?". "Sobre 3.000U,dice el PN. 
Decimos, "Vaya". 

Los submenús, también llamados menús de cascada, son menús que abri- 
mos desde otros menús. La Swing indica si un elemento de menú es realmen- 


te un submenú añadiendo una flecha seleccionable a la derecha del elemento 
de menú; cuando el usuario hace clic sobre la fecha, se abre el submenú. 

Puede crear menús de submenús fácilmente en la Swing. Lo único que 
hace falta es crear un nuevo menú, añadir elementos al menú y después añadir 
el mismo, como elemento en otro menú. 

Aquí tiene un ejemplo que lo aclara. En este caso, puede añadir un submenú 
a un menú y proporcionar al submenú cuatro elementos. Aquí tiene la apa- 
riencia del código: 

import java.awt.*; 


import javax.swing.*; 
import java.awt.event.*; 
pe 
<APPLET 
CODE = submenus.class 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
È 


public class submenus extends JApplet 


{ 


public void inito0 
I 


menuBar jmnubar = new J'MenuBaro; 


menu jmenu = new JMenu("Sub Menús", true); 
menu jsubmenu = new JMenu ("Menú en cascada", true); 


Jemenu, add] “Elemento 137 
Jasni. add] "Elamacto 27); 


iso. addi "Elemento J=)? 
jmenu dd i "Elemento àj; 


Jjsubmenu.add ("sub Elemmnto 1"); 
jsubmenu.add ("Sub Elemento 2"); 
Jjsubmenu.add ("Sub Elemmnto 3"); 
jsubmenu.add ("Sub Elemento 4"); 
asco dell jmubmami) F 

Jasmibars. add] fauna) r 

pat JHandiar |jnanubāar) y 


La figura 16.5 muestra el resultado de este código. Como puede ver, el 
submenú se abre cuando el usuario selecciona el elemento de menú corres- 
pondiente. Este ejemplo se encuentra en el archivo submenus.java del CD. 
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Figura 16.5. Creación de submenús. 


Crear aceleradores y mnemónicos de menú 


"Dígame", dice el zar de la corrección de la programación, "¿qué hay 
acerca de aquellos elementos de menú que a veces veo que tienen aceleradores 
de teclado? Apuesto a que no puede hacerlo en Java". "Seguro que se puede", 
decimos, "con mnemónicos de menús y aceleradores". 

Los aceleradores y mnemónicos de menú proporcionan acceso de teclado 
a elementos de menú. Los mnemónicos están representados por caracteres 
subrayados en el texto de un menú o elemento de menú. Cuando el usuario 
pulsa la meta tecla para el sistema (como la tecla Alt en Windows) y la tecla 
de mnemónicos, se abre el elemento de menú. Puede asignar un mnemónico 
de menú o de elemento de menú con el método setMnemonic. 

Los aceleradores son muy similares a los mnemónicos, excepto en que se 
especifican las pulsaciones de tecla reales necesarias para activar un elemen- 
to de menú, como F1, Control+X y así sucesivamente (la meta tecla no se 
utiliza en aceleradores de menú a menos que especifique que debiera ser así). 
Puede añadir un acelerador a un elemento de menú (no a menús) con el 
método setAccelerator, el cual recibe un objeto de la clase KeyStroke que 
define la pulsación de tecla que quiere utilizar como acelerador. Aquí tiene el 
diagrama de herencia para la clase KeyStroke: 


La tabla 16.12 muestra los métodos de la clase KeyStroke. 

Puede utilizar las constantes de teclas definidas en la clase KeyEvent 
(KeyEvent.VK-A, KeyEvent.VK-ENTER y KeyEvent.VK-TAB) paraespe- 
cificar el código de tecla cuando crea un objeto KeyStroke. Los modificado- 
res que puede especificar pueden ser cualquier combinación de los siguientes: 


* Event SHIFT_MASK (= 1) 
* Even. CTRL_MASK [= 2) 
. Eveni. META_ MASK (= #4) 
= Eş 


en ALT MASK (= 8) 


Tabla 16.12. Métodos de la clase KeyStroke. 


Metodo 


boolean equals(Object anobject) 


char getKeyChar() 
int getKeyCode() 


static KeyStroke getKeyStroke(char 
keyChar) 


static KeyStroke getKeyStroke(char 
keyChar, boolean onKeyRelease) 


static KeyStroke getKeyStroke(int 
keyCode, int modifiers) 


static KeyStroke getKeyStroke(int 
keycode, int modifiers, boolean on- 
KeyRelease) 


static KeyStroke getKeyStroke(String 
representation) 


static KeyStroke getKeyStrokeFor- 
Event(KeyEvent anEvent) 


Descripción 


Devuelvetrue si el objeto es idéntico 
al objeto indicado. | 


Obtiene el carácter definido por este 
objeto KeyStroke. 


Obtiene elcódigo numéricode tecla 
definido para este objeto KeyStroke. 


Devuelve una instancia compartida 
de pulsación de tecla que se activa 
cuando se pulsa la tecla. 


Obsoleto. UtilicegetKeyStroke(char). 


Devuelve una instancia compartida 
de una pulsación de tecla dado un 
código de carácter y un conjunto de 
modificadores. La tecla está activa- 
da cuando se pulsa. 


Obtiene una instancia compartida 
de una pulsación de tecla dado un 
código de tecla numérico y un con- 
junto de modificadores. 


Analiza una cadena y devuelve un 
KeyStroke. 


Devuelve una pulsación de tecla a 
partir de un evento. 


Método Descripción 


int getModifiersO Obtiene las teclas modificadoras 
definidas para este objeto KeyStro- 
ke. 


int hashCode() Obtiene un valor numérico para este 
objeto como valor de índice en una 
tabla hash. 


boolean isOnKeyRelease() Devuelve true si esta pulsación de 
tecla está activa en el momento de 
soltar la tecla. 


String toString() Obtiene una cadena que visualiza e 
identificalas propiedades del objeto. 


Lo veremos todo en un ejemplo. En este caso, puede añadir un mnemónico, 
la letra N al elemento Nuevo en el menú Archivo y asignar el acelerador 
Control+N. Aquí tiene la apariencia del código: 


import java.awt.*; 
import jJavax.swing.*; 
import java.awt.event.*; 


/* 
<APPLET 
CODE = menuaccelerator.class 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
sj 


public class menuaccelerator extends JApplet implements ActionListener 
( 
public void initoO0 


{ 
Container contentPane = getContentPane0; 


JMenuBar jmenubar = new JMenuBaroO; 
JMenu jmenu = new JMenu ("Archivo"); A 
JMenultem jmenuitem = new JMenultem("Nuevo... ); 


jmenu.adad ( jmenuitem) ¿ 
jmenu.add ("Abrir ... ); 
jmenu.addSeparatorO; 
jmenu.add ("Salir"); 


Jmeznulten. at hnanaonile EayEveant .YVYE_ H} p 


KeyStroke keystroke = ~e~~troke.getKeyStroke (ñey~vent.~-U, 


Event .CTRL-MASK) ; 


imenciten.aticcalerator |kèyātrokea] y 


public void actionPerformed (ActionEvent e) 
I 
showStatus ("Seleccionó el elemento Nuevo."); 


) 
1 


La figura 16.6 muestra el resultado, donde puede ver tanto el mnemónico 
(la N subrayada en el elemento de menú Nuevo) como el acelerador 
(Control+N). Proporcionar mnemónicos y aceleradores como éstos puede 
acelerar las cosas para los usuarios que no quieran alternar entre el teclado y 
el ratón una y otra vez. Este ejemplo se encuentra en el archivo 
menuaccelerator.java del CD. 


[Ear Temm ear rita ala — REO 


Figura 16.6. Mnernónicos y aceleradores de menú. 


Habilitarlinhabilitar elementos de menú y cambiar 
títulos en tiempo de ejecución 


"Ese maldito Felipe", dice el programador novato, "hizo clic con el ratón 
sobre la opción incorrecta en mi programa en el momento inadecuado, lo que 
hizo que mi código intentara comprobar el correo electrónico cuando ni 
siquiera estaba conectado a la red Internet". "Vaya con Felipe", decimos. 
"¿Qué tal si inhabilitamos los elementos de menú cuando no sean adecua- 
dos?". "¡Perfecto!" dice el PN. 


Puede habilitar o inhabilitar elementos de menú con el método setEnabled; 
cuando un elemento de menú está inhabilitado, aparece atenuado y no se 
puede pulsar. Aquí tiene un ejemplo rápido en el que permitimos que el 
usuario habilite un elemento de menú en el menú Edición de un applet. Para 
hacerlo, añada otros elementos al menú Edición: Inhabilitar elemento infe- 
rior y Habilitar elemento inferior. Cuando el usuario hace clic sobre Inha- 
bilitar elemento inferior, inhabilitamos un tercer elemento de menú en el 
menú Edición y cambiamos su texto a "Elemento inhabilitado" con el méto- 
do setText; cuando el usuario hace clic sobre el elemento Habilitar elemento 
inferior, habilitamos un tercer elemento y cambiamos su texto a "elemento 
habilitado". Aquí tiene el código: 

import Java.awt.*; 


import jJavax.swing.*; 
import jJava.awt.event.*; 


Je 
<APPLET 
CODE = menudisable.class 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
Ef 


public class menudisable extends JApplet implements ActionListener 


( 
JMenuBar jmenubar = new JMenuBaro0; 


JMenu jmenul = new J-en(Archivo"); 
JMenu jmenu2 new JMenu ("Edición"); 


JMenultem jmenuiteml = new JMenultem ("Nuevo . PRO EA 
Jjmenuitem2 = new JMenultem("Abrix.. ), 
Jjmenuitem3 = new JMenultem("SalirM), 
jmenuiteml = new JMenu-tem("Inhabilitarbotón inferiorm), 
jmenuitem5 = new JMenultem("Habilitar botón inferiorn), 
jmenuitemó = new JMenultem ("Elemento habilitadom) ; 


public void init() 


{ 


jmenuiteml.set-ction-ommand ("Selecciomuevo"); 
jmenuitem2.set~ction~ommand ("Selecciodórir"); 


jmenu? addi jmenui ters j 


jara add] Jmenuitemt t? 


jmenuitem4.setA~tiO0nCO0~d("Sele~ciotótar"); 
jrnenuitem5.~etActionCommand seleccionó Copiar"); 


jeerulcomnd.addhctionlistener (£h1 


imenrulteah. att ionli tenes (tha 


1 METIO TT 


public void actionPerformed(ActionEvent e) 
{ 
JMenuItem jmenuitem = (JMenuItem)e.getSource(); 
if (jmenuitem == jmenuitem4) { 
jmenvitemó.cstText "Elemento imbabilitado*t; 
ijmenviteanéó.setiEnabled fala); 
1 
ifijpmenvitem == jpsmiitens] 1 
jinmenvultenó setText "Elemento habilitado"! 
Jmenuitens . setEnablad| true); 


La figura 16.7 muestra el resultado de este código. Cuando el usuario 
selecciona los elementos del menú Edición, el elemento inferior en ese menú 
está habilitado o inhabilitado correctamente y su título se cambia según sea 
necesario. Eso es todo. Este ejemplo 


menudisable-java del CD. 


[taria vent ratas ia 


PoE arial 


Figura 16.7. Inhabilitar elementos de menú. 


se encuentra en el archivo 


Añadir y eliminar elementos de menú en tiempo 


de ejecución 


El gran jefe dice, "Estamos basando las opciones disponibles en nuestro 
nuevo programa en la cantidad que paga el usuario”. Preguntamos: "¿Qué?". 
"Una vez hayamos determinado cuánto dinero tiene el usuario, habilitaremos 
el número adecuado de elementos de menú”. "¿Qué?", preguntaremos. 

Puede añadir elementos de menú a los menús en tiempo de ejecución con 
el método add y eliminarlos con el método remove. Aquí tiene un ejemplo en 
el que añadimos un nuevo elemento de menú a un menú cuando el usuario 
hace clic sobre Añadir elemento y lo eliminamos cuando el usuario hace clic 
sobre Eliminar elemento. Aquí tiene el código: 


import java.awt.?*; 


import javax.swing.* 


; 


import jJava.awt.event.*; 


“APPLET 


CODE = menuupdate.class 


WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
*7 


public class menuupdate extends JAppiet implements ActionListene~ 


I 


JMenuBar jmenubar = new JMenuBar () ; 


JMenu jmenul = new JMenu("Archivo") ; 
menu jmenua = new JMenu("-dici6n"); 


JMenultem jmenuiteml 


jmenuitem2 = 
jmenuitem3 = 
jmenuitem4 = 
jmenuitem5 = 
jmenuitemé = 


new 
new 
new 
new 
new 


public void init () 


( 


= new JMenultem("Nueva.. " ] 
JMenultem("Abrir..'), 
JMenultem("Salir"), 
Jsen-Item(-Añacfirelementom), 
J'Men-Item(“Eliminarlemento"), 
JMenultem ("Nuevo elementon); 


jmenul .add (jmenuiteml); 
jmenul . add (jmenuitem2); 
jmenul .addSeparatoroO; 


jmarnol ¿add ijaariltom3l ; 


jmenuiteml.set-ctionC--and("Sele-ciMmuóo"); 
jmenuitem2. setActionCommand ("Seleccionó Abrir"); 


párnolcteal, addictionListener {thi 


imengiten2.addActionLast 


jenu? add [imentitená ll; 


jmenu ati i mano tamt] 


jmenuitem4.setActionComrnand (" Seleccionó Cortar"); 
jrnenuitem5.~etActionCommand ("SeleccionóCopiar"); 


imenuitemi . addictiooLieterer (this 
jmepul tann, addictionListererithia) 
imenubar, adel i imanul | 


imenubar add (jimena lt 


A A pi 


public void actionPerformed (ActionEvent e) 


y JMenultem jmenuitem = (JMenultem)e.getSource( ):; 
if (jmenuitem == jmenuitem4) i 
jmenu2 .add (jmanuitem6) 5 
1 
if (jmenuitem == jmenuit-5) i 
jmenu2 . remove (jmenuitem6) ; 
1 
1 


1 


La figura 16.8 muestra el resultado de este código, donde puede ver el 
nuevo elemento añadido cuando el usuario hace clic sobre Añadir elemento. 


Figura 16.8. Añadir y eliminar elementos de menú en tiempo “e ejecución. 


m 


El usuario puede eliminar el nuevo elemento haciendo clic sobre Elimi- 
nar elemento. Observe que puede crear nuevos elementos de menús en el 
momento con el operador new y puede añadir tantos elementos de menú a un 
menú como desee en tiempo de ejecución. Este ejemplo se encuentra en el 
archivo menuupdate-java del CD. 


Añadir botones y otros controles a menús 


Puede añadir controles como botones a menús de la Swing. De hecho, 
hacerlo es sencillo; basta con utilizar el método add de la clase JMenu. Por 
ejemplo, aquí tiene la forma de añadir un objeto JButton a un menú, haciendo 
que el código muestre un mensaje cuando el usuario hace clic sobre el botón: 


import java.awt.*; 
import javax.swing.*; 
import jJava.awt.event.*; 


pe 
<APPLET 
CODE = menucontrols.class 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
/ 


public class menucontrols extends JApplet implements ActionListener 
{ 
public void init () 


{ 


JMenuBar jmenubar = new JMenuBaroO; 


JMenu jmenul = new JMenu ("Archivon); x 
JMenuItem jmenuiteml = new JMenultemí"Nuevo... ), 
jmenuitem2 = new ~~enuItem ("Abrir"), 
jmenuitem3 = new JMenuItem("SalirU); 
JButton jbutton = new JB-tton("iPúlsame!-); 
jbutton.setActionConanand ("Ha hecho clic sobre el botón"); 
jbutton.addActionListener (this); 


mar dr 
[marul atdi fbuttos): 
paisi parat 


JMenu jmenu2 = new JMenu ("EdiciÓnŲ; 
JMenuItem jmenuitem4 = new JMenuItemí"Cortar"), 
jmenuitem5 = new ~~enuItem("Copiar"), 


jmenuitemó = new JMenultem("PegarW) 


public void actionPerformed (ActionEvent e) 

I 
JButton jbutton = (JButton)e.getSource (); 
showStatus (jbutton.getActionCommandO) ; 


1 


La figura 16.9 muestra el resultado de este código. Como vemos, se añade 
un botón completamente funcional al menú Archivo del applet. Este ejemplo 
se encuentra en el archivo menucontrols.java del CD. 
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Figura 16.9. Añadir un botón a un menú. 


Crear menús emergentes 


El gran jefe está enfadado y dice, "¡Todas las nuevas características que 
mantener, todos estos programadores que contratar! ¡Qué coste! ¡Ahorason 
menús emergentes, nada menos!". "Está bien", decimos, "puedo añadirlos a 
nuestros programas si planifica un poco más de tiempo”. El GJ grita: "¡El 
coste! ¡El coste!". 


Los menús emergentes son esos menús que el usuario puede visualizar 
haciendo clic con el botón derecho del ratón cuando está situado sobre un 
componente. En la Swing, los menús emergentes quedan soportados por la 
clase JPopupMenu (lo adivinó). Aquí tiene el diagrama de herencia para esta 
clase: 


La tabla 16.13 muestra los constructores para la clase JPopupMenu y la 
tabla 16.14 sus métodos. 


Tabla 16.13. Constructores de la clase JPopupMenu. 


Constructor Descripción 


JPopupMenu() Construye un JPopupMenu. 


JPopupMenu(String label) Construye un JPopupMenu con el 
título indicado. 


Tabla 16.14. Métodos de la clase JPopupMenu. 


Método Descripción 


JMenultem add(Action a) Añade un nuevo elemento de menú 
al final del menú, que inicia laacción 
indicada. 


JMenultem add(JMenu1temmenultem) Añade el elemento de menúindicado. 


JMenultem ada(String s$) Construye un nuevo elemento con 
el texto indicado y lo añade al final 
del menú. 

void addPopupMenuListener(Popup- Añade un receptor PopupMenuLis- 

MenuListener 1) tener. 

void addSeparator() Añade un nuevo separador al final 
de un menú. 


protected PropertyChangeListener Crea un receptor de cambios de 
createActionChangeListener(JMenu- acción. 
Item b) 


Método Descripción 


protected void firePopupMenuCan- 
celedo 


protected void firePopupMenuWill- 
Becomelnvisible() 


protected void firePopupMenuWill- 
BecomeVisible() 


AccessibleContextgetAccessible- 
Contexto 


ComponentgetComponent() 


| ComponentgetComponentAtindex 
(int i) 


Informa a los receptores de este 


menú emergenteque hasido cance- 
lado. 


Informa a los PopupMenuListeners 
de que este menú emergente va a 
pasar a ser visible. 


Informa a los PopupMenuListeners 
de que este menú emergente será 
visible. 


Obtiene el AccessibleContext. 


Obtieneel Componentutilizadopara 
pintar el elemento recibido. 


Obtiene el componente en el índice 
indicado. 


int getComponentindex(Componentc) Obtiene el índice del componente 


static boolean getDefaultLightWeight 
PopupEnabled() 


Component getinvokero 


String getLabel() 


Insets getMargin() 


SingleSelectionModelgetselection- 
Modelo 


MenuElement[] getSubElements() 


PopupilenuLl getti) 


indicado. 


Devuelve el valor por defecto para 
lapropiedad ligntWeightPopupEna- 
bled. 


Obtieneelcomponenteque "invoca" 
este menú emergente (es decir, el 
componenteen que se muestra este 
menú emergente). 


Obtiene la etiqueta del menú emer- 
gente. 


Obtiene el margen entre el borde 
del menú emergente y sus compo- 
nentes contenidos. 


Obtiene el modelo de objeto que 
procesa selecciones simples. 


Debería devolver una matriz que 
contiene los subelementos. 


Obtiene el objeto apariencia que 
renderiza este componente. 


| Metodo Deseripeión 


String getUlClassID() Obtiene el nombre de la clase apa- 
riencia que renderiza este compo- 
nente. 

void insert(Action a, int index) Inserta un elemento de menú para 


el objeto Action indicado en una 
posición dada. 


void insert(Component component, Inserta el componente indicado en 


int index) un menú en una posición dada. 
boolean isBorderPainted() Comprueba si el borde debería pin- 
tarse. 


booleanisLightWeightPopupEnabled() Devuelve true si los emergentes de 
poco peso se utilizan y false si se 
utilizan en cambio componentes de 


más peso. 
boolean isVisible() Devuelve true si el menú emergente 
está visible. 
void menuSelectionChanged(boolean Se llamacuando cambia la selección 
isIncluded) de menú. 
void pack() Distribuye el contenedor para que 


utilice el espacio mínimo paravisua- 
lizar sus contenidos. 


protected void paintBorder(Gra- Pinta el borde del menú emergente. 
phics g) 
protected String paramStringO Obtiene una representación de 


cadena de este JPopupMenu. 


void processKeyEvent(KeyEvente, Procesa un evento de tecla. 
MenuElement[] path, MenusSelection 
Manager manager) 


void processMouseEvent(Mouse Procesa un evento de ratón. 
Event event, MenuElement[] path, 
MenusSelectionManager manager) 


void remove(Componentcornp) Elimina el componente indicado. 

void remove(int pos) Eliminaelcomponenteenla posición 
indicada. 

void removePopupMenuListener Elimina un receptor PopupMenuLis- 


(PopupMenuListener 7) tener. 


| Método 


void setBorderPainted(boo1ean b) Asigna si el borde debería pintarse. 


static void setDefaultLightWeightP0-  Asignael valor predeterminadopara 


pupEnabled(boo1eanaFlag) lapropiedad lightWeightPopupEna- 
bled. 

void setinvoker(Component invoker) Asigna el invocador para este menú 
emergente. 

void setLabel(String label) Asigna la etiqueta de menú emer- 
gente. 

void setLightWeightPopupEnabled  Seleccionasise utilizaun emergente 

(boolean aFlag) de poco peso si es conveniente. 

void setLocation(int x, int y) Asigna la posición de la esquina 
superior izquierda del menú emer- 
gente. 

void setPopupSize(Dimension d) Asigna el tamaño del emergente 
utilizando el objeto Dimension. 

void setPopupSize(int width, int Asigna el tamaño del emergente. 

height) 

void setSelected(Component sel) Asigna el componenteseleccionado 
en curso. 

void setSelectionModel(SingleSelec- Asigna al modelo de objeto para 

tionModel model) procesar selecciones simples. 

void setUl(PopupMenuUlI ui) Asigna el objeto apariencia que 


dibuja este componente. 
void setVisible(boolean b) Asigna la visibilidad de menú. 


void show(Component invoker, int x, Muestra un menú emergente. 
int y) 


void updateUl() Llamada por UlFactorycuando cam- 
bia la apariencia. 


Puede crear menús emergentes, añadirles nuevos elementos con el método 
add y después visualizarlos con el método show. 

Vamos a examinar un ejemplo. En este caso, creamos un menú emergente 
con tres elementos (Cortar, Copiar y Pegar) que aparecerán cuando el 
usuario hace clic sobre el botón derecho del ratón. Los menús emergentes 
tienen que ser hijos de algún otro componente, por lo que añadiremos una 
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etiqueta a un applet y cubriremos el applet con la etiqueta. Aquí tiene la 
creación de la etiqueta y el menú emergente en el código: 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


AS 
<APPLET 
CODE = popup.class 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
*/ 


public class popup extends JApplet implements MouseListener 


( 
JLabel jlabel = new JLabel (";Haz clic con el botón derecho! "5 


JLabel .CENTER) ; 
JPopupMenu jpopupmsnu = new irPopuplüenu0; 


public void init () 
I 


Container contentpane = getContentPane0; 


jpopu-nu.add (neorJMenuIt~inCortarmew ImageIc~n (~item. jpg~))); 
jpopupmenu.add (neorJMenuIt~ ("CopiarmpeprImageI~on (~item.jpg~))); 
jpopupmen” .add(new-enult- (-PegaewJImagel-on (~item. jpg"))); 


label .adimoureListeneritihia) 
contentPaña. add (label); 


Ahora, cuando el usuario hace clic sobre un botón de ratón, puede com- 
probar si se hizo sobre el botón derecho del ratón utilizando el método 
getModifiers de la clase MouseEvent y la máscara para el botón derecho del 
ratón (InputEvent.BUTTON3-MASK). Si se hizo clic sobre el botón derecho 
del ratón, mostraremos el nuevo menú emergente en la posición del ratón, 
como sigue: 


public void mousePressed (MouseEvent e) 
( 
if((e.getModifiers() 8 lnputEvent.BUTTON3-MASK) == 
InputEvent . BUTTON3-MASK) 
jpopupmenu.show(jlabel, e.getX0, e.getY0); 


public void mouseClicked (MouseEvent e) O 
public void mouseReleased (MouseEvent e) O 
public void mouseEntered (MouseEvent e) O 
public void mouseExited (MouseEvent e) (1 


La figura 16.10 muestra el resultado. Cuando el usuario hace clic con el 
botón derecho sobre la etiqueta en el applet, el menú emergente aparece en la 
posición del ratón, como se muestran en la figura. Eso es lo único necesario 
para visualizar menús emergentes. Este ejemplo se encuentra en el archivo 
popup.java del CD. 
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Figura 16.10. Visualizar un menú emergente. 


Crear barras de herramientas 


"Los menús están bien", dice el programador novato, "pero algunas veces 
trabajo demasiado rápido para usarlos, por lo que tengo muchos aceleradores 
de menús en mi programa. Pero ahora quiero olvidarlos". Sonreímos y deci- 
mos: "¿Ha probado a añadir una barra de herramientas?" 

Las barras de herramientas visualizan botones y otros controles que repre- 
sentan acciones comunes de su programa, como guardar un archivo o pegar 
los contenidos del portapapeles. Los botones de la barra de herramientas a 
veces representan elementos de menús usados con frecuencia en su sistema 
de menús. En la Swing, utilizamos la clase JToolBar para crear barras de 
herramientas. Aquí tiene el diagrama de herencia de la clase JToolBar: 


java lang Object 


java. awt Component 
H= java. At COoncainer 
+ avax. fking. JCorganent 


java, maing JToolaar 


= 
E 
=d 
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La tabla 16.15 muestra los constructores de la clase JToolBar y la tabla 
16.16 sus métodos. 

Aquí tiene un ejemplo en el que añadimos una barra de herramientas con 
los botones a un programa. Observe que, en cierta forma, una barra de 
herramientas actúa como un componente que contiene otros componentes; 
tiene que añadirlo a la distribución de su programa donde quiera. Sin embar- 
go, cuando lo ha hecho, el usuario puede arrastrar el indicador de la barra de 
herramientas, que aparece a la izquierda, y realinear la barra de herramientas 
con cualquier borde en que aparezca la barra de herramientas. De hecho, el 
usuario puede dejar flotar sencillamente la barra de herramientas en el espa- 
cio, sin alinearla con ningún borde de la ventana. 


Tabla 16.15. Constructores de la clase JToolBar. 


Constructor Descripción 


JToolBar[) Construye una nueva barra de herra- 


mientas. 


JToolBar(intorientation) Construyeuna nueva barra de herra- 
mientas con la orientación dada. 


Tabla 16.16. Métodos de la clase JToolBar. 


Método Descripción 


JButton add(Action a) Añade un nuevo JButton que inicia 
la acción. 


protected void addlmpl(Component Añade el componente indicado a 
comp, Object constraints, int index) este contenedor en la posición indi- 
cada. 


void addseparatoro Añade un separador de barra de 
herramientas. 


void addSeparator(Dimensionsize) Añade un separador de barra de 
herramientas con las dimensiones 
dadas. 


protected PropertyChangeListener Crea un receptor de cambio de 
createActionChangeListener(JButtonb)acción. 


AccessibleContextgetAccessibleCon- Obtiene el AccessibleContext. 
texto 


Component getComponentAtindex Obtiene el componente en el índice 
(int i) indicado. 


Metodo Descripción 


int getComponentindex(Componentc) Obtiene el índice del componente 


indicado. 

Insets getMargin() Obtiene el margen entre el borde de 
la barra de herramientas y sus boto- 
nes. 

int getOrientation0 Obtiene la orientación actual de la 
barra de herramientas. 

ToolBaril get) Obtiene lainterfazde usuario actual 
de la barra de herramientas. 

String getUlClassID() Obtiene el nombre de la clase apa- 
riencia que renderiza este compo- 
nente. 

boolean isBorderPaintea() Comprueba si el borde debe pintar- 
se. 

boolean isFloatable() Devuelve true si la barra de herra- 
mientas puede ser arrastrada por el 
usuario. 

protected void paintBorder(Gra- Quita el borde de la barra de herra- 

phics g) mientas. 

protected String paramString() Obtiene una representación de ca- 
dena de esta barra de herramientas. 

void remove(Componentcomp) Elimina el componente de la barra 
de herramientas. 

void setBorderPainted(boo1ean b) Asigna si el borde debería pintarse. 

void setFloatable(boolean b) Asigna si la barra de herramientas 


se puede hacer flotar. 


void setMargin(Insets m) Asigna el margen del borde de la 
barra de herramientas y sus botones. 


void setOrientation(int o) Asigna la orientación de la barra de 
herramientas. 


void setUl(ToolBarUl ui) Asigna el objeto apariencia que ren- 
deriza este componente. 


void updateUl() Llamada por UlFactorycuando cam- 
bia la apariencia. 


En el código de este ejemplo, utilizamos sencillamente el método add de 
la clase JToolBar para añadir dos botones a una barra de herramientas y 
utilizamos el método addseparator para añadir algo de espacio entre los 
botones. También añadimos código para hacer que el applet visualice los 
botones de la barra de herramientas sobre los que ha hecho clic el usuario y 
añadimos la barra de herramientas a la sección norte del panel de contenidos 
de la distribución de borde. Aquí tiene el código: 


A , * 

import java.awt. 5 

import javax.swing.*; 
import java.awt.event.*;}; 


/* 
CAPPLET 
CODE = toolbar.class 
WIDTH = 500 
HEIGHT = 280 > 
</APPLET> 
*1 


public classtoolbar extendsJApplet implementsActionListener, ItemListener 
( 
JButtonjbuttonl=newJButton ("Botón1l",newImagelcon ("button.Jpg*)); 
JButton jbutton2 =newJButton ("Botón2", newImagelcon ("button.jpg")); 


public void init () 
{ 


Container contentpane = getContentPane0; 
JToolBar jtoolbar = new JToolBaro; 


Jbutrosi.aldictionLlatenaritbla!l;s 
jbuttoni.adádħctionListenear {this} p 


jetocolbar.s dd (fbuttonil y; 
jecbolbar,addseparatori(l; 
Jjetoolbar.adal (fbuttonzh; 


contentPane.add(jitoolbar, Borderlayout. NORTH!" 


public void action-erformed(ActionEvente) 
I 
if(e.grtSource() == jbutton1) Í 
showStat-s (“Hizolic sobre el botón 1”); 
1 elee if (e.getSource0 == jbutton?) Í 
showStatus ("“«izoclic sobre el botón 2"); 


La figura 16.11 muestra el resultado de este código, donde puede ver los 
dos botones de la barra de herramientas. Observe también el indicador de la 
barra de herramientas a la izquierda de la misma, que el usuario puede utilizar 
para moverla, alineándola como sea necesario o dejándola flotar libremente. 
Este ejemplo (el archivo toolbar.java del CD) es un éxito. 


i: naira a brir d 


Figura 16.11. Mostrar una barra de herramientas con dos botones. 


Añadir cuadros combinados y otros controles a 
barras de herramientas 


El especialista de soporte a productos está poco feliz y dice, "Los usuarios 
se están quejando de nuevo. Tenemos veinte botones en la barra de herra- 
mientas para seleccionar el tipo de letra y no existe espacio para otros 
botones". "Mmh", decimos, "eso podría ser un problema. Pondremos las diver- 
sas opciones de tipo de letra en un cuadro combinado en vez de en la barra 
de herramientas". El habitualmente lúgubre ESP se anima momentánea- 
mente. 

Puede añadir cuadros combinados y otros controles a barras de herramien- 
tas utilizando el método add de la clase JToolBar. Aquí tiene un ejemplo en el 
que añadiremos un cuadro combinado al ejemplo del cuadro de herramientas 
desarrollado en el tema previo: 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


pe 
<APPLET 
CODE = toolbar.class 
WIDTH = 500 
HEIGHT = 280 > 
</APPLET> 
./ 


public classtoolbarextendsJAppletimplementsActionListener, IternListener 
( 
JButtonjbuttonl=newJButton ( "Botón1",new Imagelcon ("button. jpg"); 
JButtonjbutton2=newJButton ("BotÓn2",newImageIcon ("button. jpg"); 
JComboBox jcombobox = new JCornboBox0; 


public void init () 
{ 


Container contentpane = getContentPane0; 


JToolBar jtoolbar = new JToolBaroO; 


Cacóar (El 


ttonos.adarctionlastenerithlel 


iecsabotes.addltes|"Elernasto 1%); 
jcomboboa. add cami “Elemento 3%)1 
jombobos.adáltea "Elemento J"); 
Jecombobeos. addi ten |" Elanentia i7) j 
Jcombobor. addItemLiotaner this); 


toolbar. mwi | 
jtoolbar addieperstoril; 


03 DUE tor 


CooLDaAT. dia para tor: 


jtoolbar.sdl liommboborx! i 


önteni Pare. dd ito] bar Hordo Layout. MIRTH] ; 


Cuando el usuario selecciona un elemento del cuadro combinado, 
visualizamos ese elemento en la barra de estado: 


public void action-erformed (~ctionEverį 


( 


if (e.getSource() == jbuttonl) ( 
showStatus ("Hizoclic sobre el botón 1"); 
) else if (e.getSource() == jbutton2) ( 


showStatus ("Hizoclic sobre el botón 2"); 


public void itemStateChanged (1temEvent e) 


String outstring = F 


if(e.getStateChange0 == ltemEvent.sELECTEri) 
outstring += "Seleccionado: tE (String)e.get-t-O; 
else 


outstring += nDaseleccionado: m + (String)e.getltem(); 


hristatasioutitringlr 


La figura 16.12 muestra el resultado de este código. Cuando el usuario 
hace clic sobre un elemento del cuadro combinado, el applet visualizará ese 
elemento en la barra de estado. Eso es todo lo que necesitamos. Este ejemplo 
se encuentra en el archivo toolbar-java del CD. 
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Figura 16.12. Añadir un cuadro combinado a una barra de herramientas. 


m Swing: 
ventanas, 

paneles, marcos 
internos y cuadros 
de diálogo 


En este capítulo, examinaremos el manejo de todo tipo de ventanas en la 
Swing. Aprenderemos cómo funcionan con las clases JWindow, JFrame, 
JDesktopPane, JInternalFrame, JOptionPane y JDialog. Estas clases pueden 
dividirse convenientemente en dos categorías: ventanas y cuadros de diálogo. 


Ventanas 


Las clases JWindow y JFrame son el equivalente de las clases Window y 
Frame en AWT y sirven para el mismo propósito. Puede utilizar la clase 
JWindow para crear una ventana simple; de hecho, no es más que un rectán- 
gulo blanco. Aunque puede añadir bordes y controles a los objetos JWindow, 
normalmente utilizará la clase JFrame para crear ventanas que presente al 
usuario. 

Las clases JDesktopPane y JInternalFrame son nuevas en Swing, aunque 
juntas representan algo que ha llegado a ser muy común en las IU: una 
interfaz de documentos múltiple. Los objetos de la clase JDesktopPane pre- 
sentan un espacio en el que puede visualizar múltiples marcos internos de la 


clase JInternalFrame. Por ejemplo, una aplicación de procesamiento de tex- 
tos podría permitir al usuario abrir varias vistas del mismo documento, o de 
múltiples documentos, utilizando un escritorio con varias ventanas de marcos 
internos. Los marcos internos son de poco peso, y dibujan ventanas que 
aparecen dentro de otras ventanas. De hecho, los paneles de escritorio tam- 
bién son componentes de poco peso, derivados de JLayeredPane. Puede aña- 
dir ventanas de marcos internos a las capas seleccionadas de un panel de 
escritorio. 


Cuadros de diálogo 


La Swing proporciona bastante soporte para cuadros de diálogo con la 
clase JOptionPane. Mediante el uso de métodos de esta clase, puede visualizar 
toda clase de cuadros de diálogo (cuadros de diálogo de mensaje, cuadros de 
diálogo de confirmación, cuadros de diálogo de entrada y muchos más). 
Como verá aquí, es sencillo crear cuadros de diálogo utilizando JOptionPane. 

Además de JOptionPane, la Swing también posee la clase JDialog, que 
puede utilizar como base para sus propias clases de cuadro de diálogo 
personalizadas. Veremos cómo utilizar JOptionPane y JDialog en profundi- 
dad en este capítulo. 

Es suficiente como resumen de lo que aparece en este capítulo. Como 
puede ver, habrá mucho más. 


Crear una ventana 


El programador novato aparece y dice, "Quiero crear una ventana comple- 
tamente personalizada en el programa". "Para eso", decimos, "necesita la 
clase JWindow, que visualiza una ventana completamente limpia". "Bien", 
dice el PN, "¿puedes escribir el código para mí?" 

La clase JWindow es muy similar a la clase Window del AWT, debido a 
que visualiza una ventana vacía que puede personalizar como desee. De 
hecho, los objetos JWindow tienen tan pocos adornos que generalmente 
utilizará en su lugar la clase JFrame. Sin embargo, si de verdad necesita 
simplicidad, JWindow es el punto de inicio. Aquí tiene el diagrama de heren- 
cia para esta clase: 


+—java.awt.Container 


+5 ava.awt . Window 


+-jJavax.swing.JWindow 


La tabla 17.1 muestra los constructores para JWindow y la tabla 17.2 sus 


métodos. 


Tabla 17.1. Constructores de la clase JWindow. 


Constructor Descripción 
JWindowO Construye una ventana. 


JWindow(Frame owner) 


JWindow(Window owner) 


Construye una ventana con el marco 
propietario indicado. 


Construye una ventana con la ven- 
tana propietaria indicada. 


Tabla 17.2. Métodos de la clase JWindow. 


Método 


Descripción 


protected void addlmpl(Component 
comp, Object constraints, int index) 


protected JRootPane createRoot- 
Pane() 

AccessibleContext getAccessible- 
Contexto 

Container getContentPane0 
Component getGlassPane0 
JLayeredPane getLayeredPane0 


JRootPane getRootPane0 


protected boolean isRootPane- 
CheckingEnabledO 


Añade un componente al panel de 
contenidos en su lugar. 


Llamada por los métodos construc- 
tores para crear el panel raíz prede- 
terminado. 


Obtiene el AccessibleContext. 


Obtiene el objeto contentpane para 
esta ventana. 


Obtiene el objeto glassPane para 
esta ventana. 


Obtiene el objeto layeredPane para 
esta ventana. 


Obtiene el objeto rootPanepara esta 
ventana. 


Determina si las llamadas a add y 
setLayout producen una excepción 
que debe lanzarse. 


aga 


Método Descripción 


protected String paramStringO Obtiene una representación de ca- 
dena de este JWindow. 


void remove (Componentcomp) Elimina el componente indicado de 
este contenedor. 


void setContentPane(Container con-  Asigna la propiedad contentpane. 
tentPane) 


void setGlassPane(Componentglass- Asigna la propiedad glassPane. 
Pane) 


void setLayeredPane(JLayeredPane Asigna la propiedad layeredPane. 
layeredPane) 


void setLayout(LayoutManagerma- Por defecto, la distribución de este 
nager) componente no debe asignarse. 


protected void setRootPane(JRoot-  Asigna la propiedad rootPane. 
Pane root) 


protected void setRootPaneCheck- Determina si las llamadas a add y 
ingEnabled(boo1earenabled) setLayout pueden producir una ex- 
cepción. 


protected void windowlnit() Llamada por los constructores para 
inicializar la propiedad JWindow. 


Cuando crea un objeto JWindow, puede añadirle un borde con el método 
setBorder del panel raíz, mostrar la ventana con el método show, ocultarla 
con el método hide y eliminarla con el método dispose. Observe que la 
distribución por defecto de JWindow es la distribución de borde. 

Crearemos un objeto JWindow ahora en un ejemplo. En este caso, añadi- 
remos un botón a un applet y visualizaremos la ventana cuando se pulse el 
botón. También añadiremos un borde a la ventana y un botón que, cuando se 
pulse, eliminará la ventana. Observe que los objetos JWindow tienen paneles 
de contenido como cualquier otra ventana, por lo que añadimos un botón a 
ese panel. Observe también que antes de que se pueda mostrar una ventana, 
debe tener un tamaño, que asignamos con el método setBounds. Aquí tiene el 
código: 

import java.awt.*; 


import javax.swing.*; 
import java.awt.event.*; 


a 


CODE = window.class 
WIDTH = 350 
HEIGHT = 280 > 


public class window extends JApplet implements ActionListener 


( 


JWindow jwindow = new JWindow() 5 


public void initoO0 


{ 


Container contentpane = getContentPane0; 
JButton jbutton = new JButt0ni"Mostrar ventana"); 
JButton jwindowbutton = new JButton ("CerrarU); 


contentPane.setLayout (new FlowLayouto); 


jwuilnmdor, grtisotPFacsa(] -aat hordar i 


Container windowcontentpane = jwindow.getContentPane0; 
windowContentPane.setLayout (new FlowLayouto) ; 
windowContentPane.add (jwindowbutton) ; 


jwindowbutton.addActionListenerínew ActionListeneroO ( 
public void actionPerformed (ActionEvent e) 


( 


jwindow.dispose (); 
) 
1); 


Jjbutton.addActionbistener {this} f 


public void actionPerformed (ActionEvent e) 


{ 
jwindow.setBounds (200, 200, 100, 100); 


juiodow. show] 


La figura 17.1 muestra el resultado de este código, donde puede ver la 
nueva ventana que aparece cuando el usuario hace clic sobre el botón Mos- 
trar ventana. Como vemos, la ventana tiene un borde y un botón (así como 
un aviso que añade la Swing que indica que la ventana es una ventana de 


applet). Eso es todo. Este ejemplo se encuentra en el archivo window-javadel 
CD. 


ión del panel de contenido de la vi T 
loc = contentPane,geELocation() 


I-pplestaried 


Figura 17.1. Una ventana JWindow básica. 


Crear una ventana de marco 


"Bien", dice el programador novato, "estaba equivocado. No quiero co- 
menzar sólo con una ventana básica; quiero utilizar la ventana de marco que 
ya soporte el cambio de tamaño, minimizar, maximizar y todo eso". "Bien", 
decimos. "Parece que quiere una clase JFrame". 

Hemos utilizado la clase JFrame como base de las aplicaciones Swing, por 
lo que ya está familiarizado con ella. 

Vamos a incluirla en este capítulo sobre ventanas y cuadros de diálogo 
para completar. En el capítulo 11, encontrará los campos de la clase JFrame 
que se muestran en la tabla 11.15, la tabla 11.16 muestra sus constructores y 
la tabla 11.17 sus métodos. 

Aquí tiene un ejemplo rápido que utiliza una ventana JFrame en la que 
añadimos un panel y después dibujamos y añadimos un campo de texto en el 


panel. Debido a que las ventanas JFrame se utilizan como base de las aplica- 
ciones Swing, haremos una aplicación con este ejemplo. Aquí tiene el códi- 
go: 


import javax.swing.*; 
` . * 
import java.awt. 3 


import java.awt.event.*; 


7 
<APPLET 
CODE = jframe .ciass 
WIDTH = 350 
HEIGHT = 280> 


public class jframe extends JFrame 
I 
jpanel 3; 


public jframe () 
( 


super ("AplicaciónSwing"); 
Container contentpane = getContentPane0; 


j = new jpanel(); 
contentPane.add (3); 


public static void main (String args[1) 


! final JFrame f = new jframeo; 
Ẹ i È F E 
f.addWindowListener (new WindowAdapterO ( 
public void windowClosing(WindowEvent e) ( 
System.exit (0); 
1 
1); 
1 


) 


class jpanel extends JPanel 


JTextField jtextfield = new JTextField("¡Hola desde Swing!"); 


jpanel () 

{ 
setBackground (Color.white); 
add (jtextfield) ; 
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public void paintcomponent (Graphics g) 

I 
super .paintComponent (g); 
g.drawString("iHola desde Swing!", 0, 60); 


La figura 17.2 muestra el resultado de este código. Como puede ver en la 
figura, la ventana de marco ya muestra los botones de minimizar, maximizar 
y cerrar. Este ejemplo se encuentra en el archivo jframe.java del CD. Para 
saber más sobre el uso de JFrame, como por ejemplo los detalles para cerrar 
estas ventanas, consulte el capítulo 11. 
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Figura 17.2. Uso de la clase JFrame. 


Crear un panel de escritorio 


la =] 


ba | 


El gran jefe aparece y dice, "Nuestro procesador de textos Java no es 
competitivo. La competencia puede abrir cinco documentos al mismo tiem- 
po". "Eso no es nada", decimos. "Usando un panel de escritorio, puede abrir 
diez documentos a la vez y visualizarlos todos". "Estás contratado”, dice el 
GJ. Decimos, "ya trabajo aquí”. 

El panel de escritorio de Swing representa un escritorio y nos permite 
visualizar múltiples objetos. En el siguiente tema, añadiremos ventanas de 
marcos internas a un panel de escritorio. Aquí tiene el diagrama de herencia 
para la clase JDesktopPane, que es la clase que utiliza la Swing para soportar 
paneles de escritorio: 


ivi e AANG DFEL 


La tabla 17.3 muestralos constructores de la clase JDesktopPane y la tabla 
17.4 muestra sus métodos. 


Tabla 17.3. El constructor de la clase JDesktopPane. 


Constructor Descripción 
JDesktopPaneO Construye un nuevo JDesk- 
to-Pane. 


Tabla 17.4. Métodos de !a clase JDesktopPane. 


Método Descripción 


| AccessibleContext getAccessibleContext() ObtieneelAccessibleContext. 


JinternalFrame[] getAllFrames() Obtiene todos los Jinternal- 
Frarnes mostradosen el escri- 
torio. 


JinternalFrame[] getAllFramesInLayer(int Obtiene todos los JInternal- 
layer) Frames mostrados en una ca- 
pa del escritorio. 


DesktopManagergetDesktopManagerO Obtiene el DesktopManger | 
que maneja la IU específica 
de escritorio. 


DesktopPaneUl getUl() Obtiene el objeto apariencia 
que dibuja este componente. 


String getUlClassID() Obtiene el nombre de la clase 


apariencia que dibujará el 
componente. 


boolean ¡sopaque() Devuelve true si este compo- 
nente pinta todos los puntos 
en su rango. 


protected String paramString() Obtiene la representación de 
cadena de este JDesktop- 
Pane. 


813 


Método Descripción 


void setDesktopManager(DesktopMana- Obtiene el DesktopManger 

ger d) que manejará las acciones 
muy específicas del es- 
critorio. 

void setUl(DesktopPaneUL ui) Obtiene el objeto apariencia 


que dibujará el componente. 


void updateUI() Llamada por UlManager cuan- 
do cambia la apariencia. 


Aquí tiene un ejemplo en el que únicamente añadimos un panel de escrito- 
rio al panel de contenidos de un applet. Este es el código: 
import java.awt.*; 


import javax.swing.*; 
import java.awt.event.*; 


qe 
<APPLET 
CODE = desktopframe.class 
WIDTH = 350 
HEIGHT = 280> 
</APPLET> 
/ 


public class desktopframe extends JApplet 


{ 
JDesktopPane jdesktoppane = new JDesktopPane0; 


public void kit () 


{ 
Container contentpane = getContentPane0; 


La figura 17.3 muestra el resultado de este código. Vemos en ella un panel 
de escritorio vacío, pero no es gran cosa; los paneles de escritorio son útiles 
como contenedores, no como componentes, por lo que necesitamos añadirles 
algo. Lo haremos en el siguiente tema, donde veremos los marcos internos. 


Crear marcos internos 


El gran jefe no está impresionado con el panel de escritorio de nuestro 
programa. "¿Cuáles la clave?", pregunta el GJ. "La clave", decimos, "es que 


puede visualizar ventanas dentro del panel de escritorio". "Convénzame", 
dice el jefe. "No hay problema", contestamos. 


Figura 17.3. Un panel de escritorio básico. 


Los marcos internos, soportados por la clase JInternalFrame, son ventanas 
de marco de poco peso que aparecen dentro de otras ventanas. Esta es una de 
las clases más grandes y populares de la Swing y la haremos funcionar aquí. 
Veamos el diagrama de herencia para la clase JInternalFrame: 


java.lang.Object 


+-java.awt . Component 


+-java.awt.Container 


+-javax.swing.JComponent 


+-javax.swing.JInternalFrame 


La tabla 17.5 muestra los campos de la clase JInternalFrame, la tabla 17.6 
sus constructores y la tabla 17.7 sus métodos. 


Tabla 17.5. Campos de la clase JinternalFrame. 


Campo Descripción 

protected boolean closable Indica si el marco se puede 
cerrar. 

static String CONTENT-PANE-PROPERTY Nombre de la propiedad liga- 
da. 


protected JinternalFrame.JDesktoplicon 


desktopicon 


static String FRAME-ICON-PROPERTY 


protected Icon framelcon 


static String GLASS-PANE-PROPERTY 


protected boolean iconable 


static String IS-CLOSED-PROPERTY 


static String IS-ICON-PROPERTY 


static String IS-MAXIMUM-PROPERTY 


static String IS-SELECTED-PROPERTY 


protected boolean isClosed 


protected boolean islcon 


protected boolean isMaximum 


protected boolean isselected 


static String LAYERED-PANE-PROPERTY 


Descripción 


El icono visualizado cuando 
el marco se convierte en un 
icono. 


El nombre de la propiedad 
ligada FRAME-ICON-PRO- 
PERTY. 


El icono mostrado en la esqui- 
na superior izquierda del 
marco. 


El nombre de la propiedad 
ligada GLASS-PAN E-PRO- 
PERTY. 


Devuelve true si el marco se 
puede minimizar y visualizar 
con una imagen de icono. 


Propiedad que indica que el 
marco se puede cerrar. 


Propiedad que indica que el 
marco se ha convertido en un 
icono. 


Propiedad que indica que el 
marco está maximizado. 


Propiedad que indica que este 
marco tiene el estado de 
selección. 


Devuelve true si el marco ha 
sido cerrado. 


Devuelve true si el marco ha 
sido convertido en un icono. 


Devuelve true si el marco se 
ha expandido a su tamaño 
máximo. 

Devuelve true si el marco está 
seleccionado en la actualidad. 


Nombre de la propiedadligada 
LAYERED-PANE-PROPERTY. 


protected boolean maximizable 


static String MENU-BAR-PROPERTY 
protected boolean resizable 

static String ROOT-PANE-PROPERTY 
protected JRootPane rootPane 


protected boolean rootPaneChecking- 
Enabled 


protected String title 


static String TITLE-PROPERTY 


Descripción 


Devuelve true si el marco se 
puede expandir al tamaño del 
panel de escritorio. 


Nombre de la propiedadligada 
MENU-BAR-PROPERTY. 


Devuelve true si se puede 
cambiar el tamaño del marco. 


Nombre de la propiedad ligada 
ROOT-PANE-PROPERTY. 


La instancia de JRootPane 
para este marco. 


Devuelve true cuando las lla- 
madasa add y setLayoutpue- 
den generar una excepción. 


Eltítulo avisualizar enlabarra 
de título del marco. 


Nombre de la propiedad ligada 
TITLE-PROPERTY. 


Tabla 17.6. Constructores de la clase JinternalFrame. 


Constructor 


Descripción 


JintemalFramedt) 


| JinternalFrame(String title) 


JinternalFrame(String title, boolean resi- 
zable) 


Construye un JinternalFrame 
que no se puede convertir en 
icono, no se puede cambiar 
de tamaño, no sepuedecerrar 
y no puede expandirse hasta 
su tamaño máximo. 


Construye un JinternalFrame 
que no se puede convertir en 
icono, no se puede cambiar 
de tamaño, nosepuedecerrar 
y no puede expandirse hasta 
su tamaño máximo con un 
texto dado. 


Construye un JinternalFrame 
que no se puede convertir en 
icono, nose puede cerrar y no 


iT 


Constructor Descripción 


puede expandirse hasta su 
tamaño máximo, pero que 
puede cambiar su tamaño si 
resizeable es true. 


JinternalFrame(Stringtitle, boolean resiza- Construye un JIinternalFrame 
ble, boolean closable) que no se puede convertir en 
icono, y no puede expandirse 
hasta su tamaño máximo, 
pero que puede cambiar su 
tamaño, y cerrarse con un | 
texto dado. 


JinternalFrame(Stringtitle, boolean resiza- Construye un JInternalFrame 
ble, boolean closable, boolean maximizable) que no se puede convertir en 
icono, con el texto indicado, 
que puede cambiar de tama- 
ño, cerrarse y expandirse has- 
ta su tamaño máximo según 


se indique. 
JinternalFrame(String title, boolean resi- Construye un JinternalFrame 
zable, boolean closable, boolean maximi- con el texto indicado y con la 
zable, boolean iconifiable) posibilidad de cambio de 


tamaño, cerrarse, expandirse 
hasta su tamaño máximo y 
convertirseen un icono, según 
se indiaue. 


Tabla 17.7. Métodos de la clase JinternalFrame. 


Descripción 


protected void addlmpl(Component comp, Añade un componente hijo a 


Object constraints, int index) contentpane. 
void addInternalFrameListener(InternalFra- Añade un receptor de marco 
meListener 7) interno dado para recibir los 


eventos de marco interno a 
partir de éste. 


protected JRootPane createRootPane() Llamada por el constructor 
para configurarelJRootPane. 
void dispose() Elimina este marco interno. 
protected void firelnternalFrameEvent Dispara un evento de marco 
I (int id) interno. 


Método Descripción 


Container getContentPane0 
int getDefaultCloseOperation() 


pleon) 

JDesktopPane getDesktopPane0 
Icon getFramelcon() 

Component getGlassPane() 


JMenuBar getJMenuBarO 


int getLayer() 


JLayeredPane getLayeredPane0 
JMenuBar getMenuBarO 
JRootPane getRootPane0O 
String getTitle() 


InternalFrameUl getUl() 


String getUlClassID() 


AccessibleContext getAccessibleContext() 


JinternalFrame,JDesktopicon getDeskbo- 


Obtiene el AccessibleContext. 
Obtiene el contenpane. 


Obtiene la operación predeter- 
minada que ocurre cuando el 
usuario cierra esta ventana. 


Obtiene el JDesktoplicon utili- 
zado cuando se convierte en 
un iconoeste JinternalFrame. 


Busca en la jerarquía una ins- 
tancia de JDesktop. 


Obtiene laimagen visualizada 
en la barra de título del marco. 


Obtiene el objeto glassPane 
para este marco. 


Obtiene el JMenuBar actual 
para este JinternalFrame o 
nulo silabarra de menú no se 
asignó. 

Un método conveniente para 


obtener el atributo capa de 
este componente. 


Obtiene el objeto layeredPane 
para este marco. 


Obsoleto. Reemplazado por 
getJMenuBaro. 


Obtiene el objeto rootPane 
para este marco. 


Obtiene el título del Jinternal- 
Frame. 


Obtiene el objeto apariencia 
que dibuja este JinternalFra- 
me. 


Obtiene el nombre de la clase 
apariencia que dibuja este 
componente. 


Método 


Descripción 


String getWarningStringO 


boolean isClosable() 


boolean isClosed() 


boolean isicon() 


boolean isiconifiable() 


boolean isMaximizable() 


boolean isMaximum() 


boolean isResizable() 


protected boolean isRootPaneChecking- 
Enabled() 
boolean isSelectea() 


void moveToBack() 


void moveToFront() 


Obtienelacadenade avisoque 
se visualiza con esta ventana. 


Obtiene si se puede cerrar 
por alguna acción de usuario 
este JinternalFrame. 


Devuelve true si el Jinternal- 
Frame está actualmente 
cerrado. 


Devuelve true si el Jinternal- 
Frame está actualmente 
convertido en un icono. 


Devuelve true si el Jinternal- 
Frame se puede convertir en 
un icono por alguna acción 
del usuario. 


Devuelve true si el Jinternal- 
Frame puede maximizarse 
por alguna acción del usuario 


Devuelve true si el Jinternal- 
Frame está actualmente en 
su estado máximo. 


Devuelve true si el Jinternal- 
Frame se puede cambiar de 
tamaño por una acción de 
usuario. 


Devuelve true si las llamadas 
aadd y setLayout pueden ge- 
nerar una excepción. 


Devuelve true si el Jinternal- 
Frame esel marco selecciona- 
do actualmente. 


Mueve este componente a la 
posición -1 si su padre es un 
JLayeredPane. 


Mueve este componente a la 
posición O si su padre es un 
JLayeredPane. 


Método 5 Descripción 


void pack() Distribuye los hijos de este | 
JinternalFrame para usar su 
tamaño favorito. 


| protected void paintcomponent (Graphics g ) Llama al método paint. | 


protected String paramString() Obtiene una representación 
de cadena de este Jinternal- 
Frame. 

void remove (Component comp ) Elimina el componente indi- 
cado. 

void removelnternalFrameListener(Internal- Elimina el receptor de marcos 

FrameListener 7) internos indicado. 

void reshape(intx, int y, int width, int height) Mueve o cambia de tamaño el 
componente. 

void setClosable(boolean b) Determina si este Jinternal- 


Frame se puede cerrar por 
alguna acción de usuario. 


void setClosed(boolean b) Si pasamostrue a este méto- 
do cerramos el marco. 


void setContentPane(Containerc) Asigna este panel de conteni- 
do del JinternalFrame. 


void setDefaultCloseOperation(intoperation) Asigna la operación que 
ocurrirá por defecto cuando 
elusuariocierre estaventana. 


void setDesktoplcon(JInternalFrame. Asigna el JDesktopicon aso- 
JDesktoplicon d) ciado con este JInternalFrame. 
void setFramelcon(Icon icon) Asigna una imagen que se 


visualiza en la barra de título 
del marco (normalmenteen la 
esquina superior izquierda). 


void setGlassPane(Componentglass) Asignala propiedad glassPa- 
ne del JinternalFrame. 

void seticon(boolean b) Convierte en un iconoy realiza 
la operación inversa con el 
marco. 


void seticonifiable(boolean b) Especifica que JinternalFra- | 
me se puede convertir en un 
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Método Descripción 


icono por alguna operación 


de usuario. 

void setJMenuBar(JMenubar m) Asigna el JMenuBar de este 
JinternalFrame. 

void setLayer(1nteger layer) Asignaelatributo capade este 
componente. 


void setlayeredPane(JLayeredPanelayered) Asigna la propiedad laye- 
redPane de este Jinternal- 
Frame. 


void setLayout(LayoutManager manager) Asignala distribución del Jin- 
ternalframe. 


void setMaximizable(boolean b) Especifica si el JinternalFra- 
me puede expandirse hasta 
sutamaño máximo poralguna 
acción de usuario. 


void setMaximum(boolean b) Expande el marco a su tama- 
ño máximo o lo restaura. 


void setMenuBar(JMenubar m) Obsoleto. Reemplazado por 
setJMenuBar(JMenubar m). 


void setResizable(boolean b) Especificaqueel JinternalFra- 
me se puede cambiar de 
tamaño por alguna acción de 
usuario. 


protected void setRootPane(JRootPane Asignala propiedad rootPane. 
root) 


protected void setRootPaneCheckingEna- Determina si las llamadas a 
bled(boolean enabled) addo setLayout pueden gene- 
rar una excepción. 


void setSelected(boolean selected) Selecciona el JinternalFrame 
o lo deselecciona. 

void setTitle(String title) Asigna el título del Jinternal- 
Frame. 

void setUl(InternalFrameU1 ui) Asignael!U delegado por este 


JinternalFrame. 


void setVisible(boolean b) Asigna el estado visible del 
objeto. 


Método Descripción 


void show() Muestra este marco interno y 
lo pasa a primer plano. 

void toBack() Envía este marco interno al 
fondo. 

void toFront() Envía a primer plano este mar- 
co interno. 

| void update UI() Llamada por UlManagercuan- 

do cambia la apariencia. 


Ahora adjuntaremos un ejemplo que muestra cómo utilizar marcos inter- 
nos en un panel de escritorio. Comience añadiendo un panel de escritorio a un 
applet y añada también un objeto JPanel. Sitúe un botón con el título "nuevo 
marco interno” en el panel. Cuando el usuario hace clic sobre ese botón, 
visualiza un nuevo marco interno en el panel de escritorio. Cada marco 
interno contendrá un objeto área de texto de la clase JTextArea (que veremos 
en unos pocos capítulos; paralos propósitos de este ejemplo, actuará como la 
clase JTextArea de la AWT), permitiendo al usuario introducir texto. 

Aquí tiene la configuración del applet con un panel de escritorio y el botón 
Nuevo marco interno: 


import java.awt.*:; 
import javax.swing.*; 
import java.awt.event.*; 


/* 
<APPLET 
CODE = internalframe.class 
WIDTH = 350 
HEIGHT = 280> 
</APPLET 
*/ 


public class internalframe extends JApplet implements ~ctionListener 


( 
JDesktopPane jdesktoppane = new JDesktopPane0; 


public void init () 


( 
JPanel jpanel = new JPanelO; 


Container contentpane = getContentPane0; 


JButton jbutton = new JButton("Nuevo marco interno"); 


jbattos.addiceionListener (this); 


La acción real tiene lugar cuando el usuario hace clic sobre el botón para 
visualizar un nuevo marco interno. Proporcionamos a cada marco interno un 
nuevo texto en su barra de título, por lo que debemos controlar el número de 
marcos internos en una nueva variable: 


public class internalframe extends JApplet implements ActionListener 


( 
JDesktopPane jdesktoppane = new JDesktopPaneo0; 
static int framenumber = 1; 


public void init () 


{ 


A continuación, creamos, configuramos y añadimos nuevos marcos inter- 
nos al panel de escritorio. Aquí tiene cómo crear y configurar los marcos 
internos, asignar su posición y título. Los habilitaremos para que el usuario 
pueda cerrarlos, cambiar su tamaño, maximizar y minimizar estos marcos y 
añadir un área de texto al panel de contenidos del marco. Observe, en particu- 
lar, que los marcos internos deben hacerse visibles con el método setvisible. 
Una vez se añaden los componentes al panel de contenidos, el método pack se 
utiliza para cambiar el tamaño de la ventana de marco para que coincida con 
sus contenidos. Observe también que cuando se añaden marcos internos a 
paneles de escritorio utilizando el método add, debe especificarse una capa. 
Aquí tiene el código: 

public void action-erformed (ActionEventevent) 
E 


JInternalFrame jinternalframe = new JInternalFrameo0; 
Container contentpane = jinternalframe.getContentPane0; 


jinternalframe.setLocation(20, 20); 
jinternalframe.setTitle(mHarco interno pea framenumber) ; 
framenumber++; 


jinternalframe.setClosable (true); 
jinternalfr-.setResizable(true); 
jinternalframe.set-idzable(t-e); 
Jjinternalframe. setIconifiable(true) 5 


Jintarnalfrans -seotVisible/crue); 


contanEFaDO. patbayont {new FlowLarour (115 
contentrFané dl (or ITextácoa(5, 15), "Canter”]|; 
jinternalfrarns,.packi); 


Jjdsaktoppess.add(Jintersalfcams, 317 
F 


La figura 17.4 muestra el resultado de este código. Como verá, puede 
crear múltiples ventanas de marco interno en este applet y puede cambiarlas 
de tamaño y moverlas a voluntad. Incluso también puede minimizarlas, como 
muestra la figura. Este applet funciona tal y como fue diseñado y lo encontra- 
rá en el archivo internalframe.java del CD. 


Dlet cfaried 


Figura 17.4. Creación de marcos internos en un panel de escritorio. 


Uso de JOptionPane para crear cuadros 
de diálogo 


El programador novato está como loco y dice, "El especialista de soporte 
a productos quiere que añada 12 nuevos cuadros de diálogo a mi programa. 
¿No es codificar mucho?". "Probablemente no", decimos, "cuando utilice la 
clase JOptionPane de la Swing". "Oh", dice el PN, calmándose y comenzan- 
do a sonreír. 

La clase JOptionPane soporta un panel que utilizamos en cuadros de 
diálogo; de hecho, también proporciona métodos convenientes para la crea- 
ción de cuadros de diálogo que contienen paneles de opciones. Aquí tiene el 
diagrama de herencia para JOptionPane: 


java. Lang. at 


java. ARE, CC ra E 


La tabla 17.8 muestra los campos de JOptionPane, la tabla 17.9 muestra 
sus constructores y la tabla 17.10 sus métodos. 


Tabla 17.8. Campos de la clase JOptionPane. 


Campo 
static int CANCEL-OPTION 


static int CLOSED-OPTION 


static int DEFAULT-OPTION 


static int ERROR-MESSAGE 
protected Icon icon 


static int INFORMATION 
-MESSAGE 


static String INITIAL- 


static String INITIAL-VALUE 
-PROPERTY 


protected Object initial 
SelectionValue 


protected Object initialvalue 


static String INPUT-VALUE 
-PROPERTY 


protected Object inputvalue 
protected Object message 


static String MESSAGE 
-PROPERTY 


static String ICON-PROPERTY 


SELECTION-VALUE-PROPERTY 


Descripción 


El valor de retorno para el método de 
clase si se selecciona CANCEL. 


El valor de retorno del método de clases 
si el usuario cierra la ventana sin 
seleccionar nada. 


La apariencia no debería proporcionar 
ningunaacción, sino utilizarúnicamente 
las opciones del JOptionPane. 


Utilizado para mensajes de error. 
El icono utilizado en el panel. 


El nombre de la propiedad ligada por el 
icono. 


Usado para mensajes de información. 


Nombre de lapropiedad ligada para ini- 
tialSelectionValue. 


Nombre de la propiedad ligada para ini- 
tialvalue. 


El valorinicialparaseleccionaren selec- 
tionValues. 


El valor que debería estar seleccionado 
inicialmente en las opciones. 

Nombre la propiedad ligada para input- 
Value. 

El valor introducido por el usuario. 

El mensaje a mostrar. 


Nombre de la propiedad ligada por el 
mensaje. 


Campo 


static String MESSAGE-TYPE 
-PROPERTY 


protected int messageType 
static int NO-OPTION 


static int OK-CANCEL-OPTION 
static int OK-OPTION 


static String OPTION-TYPE 
-PROPERTY 


protected Object[] options 


static String OPTIONS 
-PROPERTY 


protected int optionType 


static int PLAIN-MESSAGE 


static int QUESTION-MESSAGE Utilizado para preguntas. 


static String SELECTION 
-VALUES-PROPERTY 


Descripción 
Nombre de la propiedad ligada por el ti- 
PO. 

El tipo de mensaje. 


El valor de retorno del método de clase 
si no se pulsa ningún botón. 


El tipo utilizado para showconfirm- 
Dialog. 

El valor de retorno del método de clase 
si selecciona OK. 

Nombre la propiedadligada para option- 
TYP~. 

Las opciones que mostrar al usuario. 
Nombre de la propiedad ligada para la 
opción. 


El tipo de acción (DEFAULT-OPTION, 
YES-NO-OPTION, YES-NO-CAN- 
CEL-OPTION o OK-CANCEL-OP- 
TION.). 


Indicaque no deberían utilizarse iconos. 


Nombre de la propiedad ligada para se- 
lectionValues. 


protected Object[] selectionValues La matriz de valores que el usuario 


| static Object UNINITIALIZED 
| -VALUE 


protected Object value 


static String VALUE-PROPERTY Nombre de la propiedad ligada para el 


static String WANTS-INPUT 
-PROPERTY 


puede seleccionar. 
Indica que el usuario aún no ha selec- 
cionado un valor. 


El valor seleccionado en curso. Será 
una opción válida, UNINITIALIZED- 
VALUE o nulo. 


valor. 


Nombre de la propiedad ligada para 
wantslnput. 


GETI 


B2B | 


protected boolean wantsInput 


static int WARNING-MESSAGE 


static int YES-NO-CANCEL 
-OPTION 


static int YES-NO-OPTION 
static int YES-OPTION 


Descripción 


Si true, un componente de la IU se 
proporcionará al usuario para obtener | 
su entrada. 


Usado para mensajes de aviso. 
El tipo usado para showConfirrnDialog. | 


El tipo usado para showConfirmDialog. 


El valor de retorno del método de clase 
si selecciona YES. 


Constructor 
| JOptionPane() 


JOptionPane(Object message) 


JOptionPane(Object message, 
int messageType) 


JOptionPane(Object message, 
int messageType, int optionType) 


JOptionPane(Object message, 
int messageType, int optionType, 
Icon icon) 


| JOptionPane(Object message, 
int messageType, int optionType, 
Icon icon, Object[] options) 


JOptionPane(Object message, 
| int messageType, int option 


| Type, Icon icon, Object[] options, 
Object initialValue) 


Tabla 17.9. Constructores de la clase JOptionPane. 


Descripción 


Construye un JOptionPa-econ un 
mensaje de prueba. 


Construye una instancia de JOption- 
Pane para mostrar un mensaje con un 
tipo de mensaje de texto sencillo y las 
opcionespredeterminadasintroducidas 
por la IU. 


Construye una instancia de JOptionPa- 
ne paravisualizar el mensaje, el tipo de 
mensaje indicado y las opciones 
predeterminadas. 


Construye unainstancia de JOptionPa- 
ne para mostrar un mensaje con el tipo 
de mensaje y opciones indicadas. 


Construye una instancia de JOptionPa- 
ne para mostrar el mensaje, el tipo de 
mensaje indicado, las opciones e icono 
indicados. 


Construye una instancia de JOptionPa- 
ne para mostrar mensaje, el tipo de 
mensaje, icono y acciones indicadas. 


Construye una instancia de JOptionPa- 
ne para mostrar mensaje, el tipo de 
mensaje, icono y opciones indicadas, 
con la opción indicada seleccionada. 


Tabla 17.10. Métodos de la clase JOptionPane. 


Método 


JDialog createDialog 
(Component parentcomponent, 
String title) 


JinternalFrame createlnternal 
Frame(Component parent 
Component, String title) 


AccessibleContext get 
AccessibleContext() 


static JDesktopPane getDesktop 
PaneForComponent(Component 
parentcomponent) 


static Frame getFrameFor 
Component(Component 
parentcomponent) 


Icon getlicon() 

Object getinitialSelectionValue() 
Object getlnitialValue() 

Object getInputValue() 


Descripción 


Construye y devuelve un nuevo JDialog. 


Construye y devuelve una instancia de 
JinternalFrame. 


Obtiene el AccessibleContext. 


Obtiene el panel de escritorio del com- 
ponente indicado. 


Obtiene el marco de componente indi- 
cado. 


Obtiene el icono que muestra el panel. 
Obtiene el valor de selección inicial. 
Obtiene el valor inicial. 


Obtiene el valor introducido por el 
usuario, si wantsinput es true. 


intgetMaxCharactersPerLineCount()Obtiene el número máximo de carac- 


Object getMessage() 


int getMessageType() 
Object[] getOptions() 


int getOptionType() 


static Frame getRootFrame() 


Object[] getSelectionValues() 


OpllonPaneLll getti) 


teres emplazado enla líneade mensaje. 


Obtiene elobjeto mensaje que muestra 
el panel. 


Obtiene el tipo de mensaje. 


Obtiene las opciones que puede realizar 
el usuario. 


Obtiene el tipo de opciones mostradas. 


Obtiene el marco a utilizar para los 
métodos de clase cuando no se 
proporcione marco. 


Obtiene los valores de selección. 


Obtiene el objeto IU que implementa la 
apariencia de este componente. 


| Método 


Descripción 


String getUlClassID() 


Object getValue() 


boolean getWantsInput() 


protected String paramString() 


void selectinitialValue() 


void seticon(lcon newlcon) 


void setinitialSelectionValue 
(Object newvalue) 


void setInitialValue(Object 
newlnitialValue) 


void setinputValue(Object 
newvalue) 


void setMessage(0bject 
newMessage) 


void setMessage Type(int 
newType) 


void setOptions(Object[] new 
Options) 


void setOptionType(int newType) 


static void setRootFrame 
(Frame newRootFrame) 


void setSelectionValues(Object[] 
newvalues) 


void setUl(OptionPaneUlI ui) 


Obtiene el nombre de la clase IU que 
implementa la apariencia para este 
componente. 


Obtiene el valor seleccionado por el 
usuario. 


Devuelve true si se proporciona al 
usuario un parentcomponent para la 
entrada. 


Obtiene una representación de cadena 
de este JOptionPane. 


Solicita que el valor inicial esté 
seleccionado, lo que dará el foco al 
valor inicial. 


Asigna el icono a mostrar. 


Asigna el valor de selección inicial. 


Asigna el estado habilitado como valor 
inicial. 


Asigna el valor de entrada del usuario. 


Asigna el objeto mensaje del panel de 
opción. 

Asigna el tipo de mensaje del panel de 
opción. 

Asigna las opciones que muestra este 
panel. 


Asigna las opciones a mostrar. 


Asignael marcoautilizar paralos rnéto- 
dos de clase en que un marco no se 
proporciona. 


Asigna los valores de selección para 
un panel que proporciona al usuario | 
una lista de elementospara seleccionar. 


Asigna el objeto que implementa la | 
apariencia de este componente. 


Metodo 


void setValue(Object newvalue) 


void setWantsinput(boolean 
newvalue) 


static int showConfirmDialog 
(Component parentcomponent, 
Object message) 


static int showConfirmDialog 
(Component parentcornponent, 
Object message, String title, 
int optionType) 


static int showConfirmDialog 
V 


static int showConfirmDialog 
(Component parentcornponent, 
Object message, String title, int 
optionType, int messageType, 
Icon icon) 


static String showInputDialog 
(Component parentcomponent, 
Object message) 


| static String showInputDialog 
(Component parentcomponent, 
Object message, String title, 
int messageType) 


static Object showInputDialog 
(Component parentcornponent, 
Object message, String title, 

int messageType, Icon icon, 
Object[] selectionValues, Object 
initialSelectionValue) 


static String showInputDialog 
(Object message) 


Descripción 


Asigna el valor seleccionado por el 
usuario. 


Si newValue es true, se añade un com- 
ponente para permitir al usuario 
introducir un valor. 


Muestra un cuadro de diálogo modal 
con las opciones Yes, No y Cancel. 


Muestra un cuadro de diálogo modal 
donde el número de opciones está de- 
terminadopor el parámetrooptionType. 


Muestra dónde el parámetro message- 
Type determina el icono para mostrar. 


Muestra un cuadro de diálogo modal, 
con el icono indicado, donde el número 
de opciones está determinado por el 
parámetro optionType. 


Muestra un cuadro diálogo de men- 
saje de pregunta solicitando entrada 
por el usuario; tiene como padre 
parentcornponent. 


Muestra un cuadro de diálogo solicitan- 
do entrada al usuario, tiene como padre 
parentcornponent con el cuadro de 
diálogo con un título title y messageTy- 
Pe. 


Solicita entradade usuario en un cuadro 
de diálogo bloqueado donde la selec- 
ción inicial, selecciones posibles y de- 
más opciones son las indicadas. 


Muestra un cuadro de diálogo de men- 
saje de pregunta solicitando entrada al 
usuario. 
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Método 


static int showInternalConfirm 
Dialog(Component parent 
Component, Object message) 


static int showlnternalContfirrn 
Dialog(Component parent 
Cornponent, Object message, 
String title, int optionType) 


static int showInternalContfirrn 
Dialog(Cornponentparent 
Cornponent, Object message, 
String title, int optionType, 

int messageType) 


static int showInternalConfirm 
| Dialog(Cornponentparent 
Component, Object message, 
String title, int optionType, int 
messageType, Icon icon) 


static String showInternallnput 
Dialog(Cornponentparent 
Component, Object message) 


static String showInternallnput 
Dialog(Cornponentparent 
Component, Object message, 
String title, int messageType) 


static Object showInternallnput 
Dialog(Componentparentcom- 
ponent, Object message, String 
title, int messageType, Icon icon, 
Object[] selectionValues, Object 
initialSelectionValue) 


static void showInternalMessage 
Dialog(Componentparentcompo- 
nent, Object message) 


static void showInternalMessage 
Dialog(Component parentcompo- 
nent, Object message, String title, 
int messageType) 


Descripción 


Muestra un cuadro de diálogo interno 
con las opciones Yes, No y Cancel. 


Muestra un cuadro de diálogo interno 
con el número de opciones predetermi- 
nado por el parámetro optionType. 


Muestra un cuadro de diálogo interno 

de númerode opcionespredeterminado 
por el parárnetro optionType, donde el 
mensaje y el parámetro messageType 
determinan el icono a mostrar. 


Muestra un cuadro de diálogo interno 
conunicono indicado, donde elnúmero 
de opciones es determinado por el 
parámetro optionType. 


Muestra un cuadro de diálogo de men- 
saje interno de pregunta solicitando 
entrada del usuario que tiene como 
padre parentcomponent. 


Muestraelcuadrode diálogo de entrada 

interno para el usuario que tiene como 

padre parentcomponent, con el cuadro | 
de diálogo con título title y el tipo de 

mensaje ressageType. 


Solicitaentradade usuarioen un cuadro 
de diálogo interno bloqueado donde la 
selección inicial, las selecciones posi- 
bles y demás opciones son las indica- 
das. 


Muestra un cuadro de diálogo de confir- 
mación interno. 


Muestra un cuadro de diálogo interno | 
que muestra un mensaje utilizando un 
icono asignado por el parámetro me- 
ssage Type. 


Método Descripción 


static void showInternalMessage Muestra un cuadro de diálogo interno 
Dialog(Componentparentcompo- que visualiza un mensaje y especifica 
nent, Object message, String title, todos los parámetros. 

int messageType, Icon icon) 


static int showInternalOptionDialog Muestra un cuadro de diálogo interno 
(Componentparentcomponent, Ob- con elicono indicado, donde las opcio- 
| ject message, String title, int op- nes iniciales están asignadas por el pa- 
tionType, int messageType, Icon  rámetro initialvalue y el número de op- 
icon, Object[] options, Object ini- ciones predeterminado por el parámetro 
tialvalue) optionType. 


static void showMessageDialog Muestra un cuadro de diálogo de con- 
(Cornponentparentcomponent, firmación. 
Object message) 


static void showMessageDialog Muestra uncuadrodediálogo quevisua- 


(Componentparentcomponent, liza un mensaje utilizando un icono pre- 
Object message, String title, int determinadoasignado por el parámetro 
messageType) messageType. 


static void showMessageDialog Muestra un cuadro de diálogo que vi- 
(Componentparentcomponent, Ob- sualiza un mensaje y especifica todos 
ject message, String title, int me- los parámetros. 

ssageType, Icon icon) 


static int showOptionDialog(Com- Muestra un cuadro de diálogo modal 

ponent parentcomponent, Object con un icono indicado, donde la opción 

message, String title, int optionTy- inicial queda determinada por el pará- 

pe, int messageType, Icon icon, metro initialvalue y el número de opcio- 

Object[] options, Object initialValue) nes queda asignado por el parámetro 
optionType. 


void updateUl() Llamadapor UlManagercuandocambia 
la apariencia. 


Puede utilizar los métodos estáticos de JOptionPane (es decir, métodos de 
clase que invocamos directamente utilizando la clase, como sigue: 
JOptionPane.showMessageDialog()) para visualizar cuatro tipos de cuadro 
de diálogo. Aquí tiene sus métodos y los cuadros de diálogo que crean: 


e showMessageDialog(). Muestra algún mensaje al usuario. 


e showConfirmDialog. Solicita la confirmación a una pregunta y recibe 
una respuesta sí/no/cancelar. 


e showInputDialog. Solicita entrada de usuario. 
e showOptionDialog. Un cuadro de diálogo configurable. 


Para cada uno de estos métodos, existe también una versión de marco 
interna (de poco peso), como showInternalMessageDialog, showInternalInput- 
Dialog y así sucesivamente, en el caso de que quiera ajustarse a marcos 
internos para conservar los recursos del sistema. 

Todos estos métodos pueden devolver un entero que indica el botón que 
seleccionó el usuario; los valores posibles son YES-OPTION, NO-—OPTION, 
CANCEL-OPTION, OK-OPTION y CLOSED-OPTION. Estos cuadros de 
diálogo son modales, lo que indica que el usuario debe cerrarlos antes de 
continuar con el resto el programa (si hace clic sobre cualquier otra ventana 
del programa únicamente genera un pitido). 

Todo esto se comprende mejor con ejemplos, por lo que analizaremos esta 
clase utilizando varios ejemplos a lo largo de los siguientes temas. 


Crear cuadros de diálogo con panel de 
opciones de confirmación 
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El especialista de soporte dice, "Necesitamos asegurar que los usuarios 
están de acuerdo con esto". Preguntamos, "¿Necesitamos asegurar que ellos 
están conformes con visualizar la suma después de que hayan pulsado el botón 
Añadir?" "Utilice un cuadro de diálogo de confirmación", dice el ESP. 

Los cuadros de diálogo de confirmación permiten al usuario hacer clic 
sobre botones para confirmar o detener una acción. Utilizamos el método 
estático showConfirmDialog de JOptionPane para crear esta clase de cuadro 
de diálogo. Aquí tiene las constantes de JOptionPane que puede utilizar con 
este método, indicando los botones que quiere mostrar: DEFAULT-OPTION, 
YES-NO-OPTION, YES-NO-CANCEL-OPTION y OK-CANCEL- 
OPTION. 

Veamos un ejemplo en el que visualizaremos el cuadro de diálogo de 
confirmación con un botón Sí y otro No. Para visualizar el cuadro de diálogo, 
sitúe un botón en un applet, y proporcione al botón el títuloMostrar diálogo. 
Cuando se pulsa el botón, utilice showConfirmDialog() para mostrar el nue- 
vo cuadro de diálogo y utilice el valor de retorno del método para indicar el 
botón que fue pulsado mostrando un mensaje en la barra de estado del applet. 
Aquí tiene el código: 


import java.awt.*; 
import javax.swing.*; 


import jJava.awt.event.*; 


Vi 
<APPLET 
CODE = dialogconfirm.class 
WIDTH = 350 
HEIGHT = 280> 
</APPLET> 
g 


public class dialogconfirm extends JApplet 


JWindow jwindow = new JWindow(); 


> 


public void init () 

( 
final Container contentpane = getContentPane0; 
JButton jbutton = new JButton ("MOstrar diálogo"); 


public void actionPerformed (ActionEvent e) 
{ 
int result = JOptionPane.showConfirmDialog( (Component) 
null, "Seleccione Sí o No", "Seleccione Sí o No", 
JOptionPane .YES-NOOPTION) ; 


if (result == JOptionPane.YES-OPTION) { 
showStatus ("Hizo clic sobre Sí."); 
) else i 


showStatus ("Rizo clic sobre W..); 
I > 


1 


La figura 17.5 muestra el resultado de este código, donde puede ver el 
cuadro de diálogo sílno. Si se pulsa un botón se cerrará el cuadro de diálogo 
y el applet indicará el botón que se pulsó con un mensaje en su barra de 
estado. Este programa se encuentra en el archivo dialogconfirm.java del CD. 


Crear cuadros de diálogo con panel de 
opciones de mensaje 


"No, no", dice el especialista de soporte de producto. "No quise decir que 
debería utilizar un cuadro de diálogo de confirmación ahí; debería ser un 
cuadro de diálogo de mensaje". "Bien", decimos, "espero que esté seguro". 


Los cuadros de diálogo de mensaje nos permiten mostrar un mensaje al 
usuario y utilizar el método estático showMessageDialog() de la clase 
JOptionPane para crear esta clase de cuadros de diálogo, pasando el mensaje 
que queremos mostrar a ese método. 
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Figura 17.5. Un cuadro de diálogo de confirmación. 


Puede seleccionar el tipo de icono que quiere visualizar en estos cuadros 
de diálogo; aquí tiene las constantes de JOptionPane que puede utilizar con 
este método para indicar el icono que quiere mostrar: INFORMATION- 
MESSAGE, ERROR-MESSAGE, WARNING-MESSAGE, QUESTION- 
MESSAGE y PLAIN-MESSAGE. 

Aquí tiene un ejemplo que le muestra cómo utilizar todos estos tipos de 
cuadro de diálogo de mensaje. En este caso, añada un botón para cada tipo de 


cuadro de diálogo y haga clic 
diálogo correspondiente: 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


/ * 
<APPLET 
CODE 
WIDTH 
HEIGHT 
< /APPLET> 
el 


350 
280 > 


public class dialogmessage 
I 
JButton Jbuttonl 
JButton jbutton2 
JButton jbutton3 
JButton jbutton4 
JButton jbutton5 


new 
new 
new 
new 
new 


public void init () 
I 


sobre el botón para visualizar el cuadro de 


dialogmessage.class 


extends JApplet implements ActionListener 


información"): 
error"); 


JButton ("MOstrardiálogo de 
JButton ("MOstrar diálogo de 
JButton ("MOstrardiálogo de aviso"); 
JButton ("MOstrardiálogo de pregunta"); 
JButtoOn ("MOStrardiálogo simple"); 


Container contentpane = getContentPane0; 


ay 


tines FlowLajy 


public void actionPerformed (ActionEvent e) 


{ 


1 


String dialogtitle = "Diálogom; 
String dialogmessage = hola desde Swingin; 
int dialogtype = JOptionPane-PLAIN-MESSAGE; 


if (e.getSource() == jbuttonl) ( 
dialogtype = JO~~~0~P~~~. INFORMATION-MESSAGE; 
) else if(e.getSource0 == jbutton2) ( 
dialogtype = JO--=“O-P="“"“., ERROR_MESSAGE; 
) else if(e.getSource0 == jbutton3) ( 
dialogtype = JOptionPane-WARNING-MESSAGE; 
) else if(e.getSource0 == jbutton4) ( 
dialogtype = JO~~~0~P~~~.QUESTION-MESSAGE; 
1 else if(e.getSource0 == jbutton5) { 


dialogtype = JO---O-P-=""“.PLAIN-MESSAGE; 
> 


JOptionPane.showMessageDialog( (Conrponent) null, 
dialogmessage, dialogtitle, dialogtype); 


La figura 17.6 muestra el resultado de este código, donde puede ver los 
botones en el applet que representan los tipos de cuadro de diálogo de mensa- 
je posibles, así como un cuadro de diálogo de información. Este ejemplo se 
encuentra el archivo dialogmessage.java del CD. 


Crear cuadros de diálogo con panel de 
opciones de campo de texto de entrada 


"No", dice el especialista de soporte a productos, "eso no tiene nada que 
ver con lo que yo quería. Yo no quería un cuadro de diálogo de mensaje; 
quería un cuadro de diálogo de entrada para permitir al usuario introducir 
algún texto". "Ya", decimos. 


Puede utilizar el método showInputDialog de la clase JOptionPane para 
mostrar un cuadro de diálogo con un campo de texto que permite al usuario 
introducir texto. Este método devuelve el texto que el usuario introdujo en el 
campo de texto o null si hizo clic sobre el botón Cancelar. 
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Figura 17.6. Creación de distintos tipos de cuadros de diálogo de mensaje. 


Aquí tiene un ejemplo en el que leemos algún texto de entrada del usuario 
y mostramos ese texto en la barra de estado del applet. El código es bastante 
sencillo. Aquí lo tiene: 


import java.awt.* ; 
import javax.swing.*; 
import java.awt.event.*; 


qe 
<APPLET 
CODE = dialogtext.class 
WIDTH = 350 
HEIGHT = 280> 
</APPLET> 
ef 


public class dialogtext extends JApplet implements ActionListener 
I 

JButton jbutton = new JButton("MOstrar diálogo"); 

String message = "Introduzca el texto"; 


public void init () 
I 
Container contentpane = getContentPane0; 


ontantPana.sotLayout (ner Flowlayout (01; 


public void actionPerformed (ActionEvent e) 


{ 
String result = JOptionPane.showInputDialog (message) ; 


if (result == null) 
show~tatus (~Hizīic sobre Cancelar"); 
else 


sho~Status (~Hescrito: + result); 


) 


La figura 17.7 muestra resultado el de este código y puede ver el cuadro de 
diálogo de entrada. Cuando el usuario hace clic sobre el botón Aceptar, el 
cuadro de diálogo desaparece y el texto del campo de entrada del cuadro de 
diálogo aparece en la barra de estado del applet. Eso es todo. Este ejemplo se 
encuentra en el archivo dialogtext.java del CD. 

Observe que puede utilizar ahowInputDialog también para otros usos; por 
ejemplo, puede mostrar un cuadro combinado en un cuadro de diálogo. Con- 
sulte el siguiente tema para más detalles. 
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Figura 17.7. Un cuadro de diálogo básico de entrada de texto. 


Crear cuadros de diálogo con panel de 
opciones para entrada de cuadros combinados 


"No, no", dice el especialista de soporte a productos, "no quería un campo 
de texto en ese cuadro de diálogo, quería un..." "¿Cuadro combinado?", 
preguntamos. "¿Cómo lo supo?", pregunta el ESP. "Telepatía", decimos. 
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Puede utilizar el método showInputDialog de la clase JOptionPane para 
mostrar una gran variedad de controles; en este tema, utilizamos un cuadro 
combinado. Para hacerlo, pase un cuadro combinado a showInputDialog así 
como una matriz para contener los elementos que desea en el cuadro combi- 
nado y el elemento que quiere seleccionado por defecto. Este caso muestra 
varios postres y permite al usuario seleccionar uno. Cuando el usuario hace 
clic sobre el botón Aceptar, se muestra la selección en la barra de estado del 
applet. Aquí tiene el código: 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


[e 
i¡APPLET 
CODE = dialogcombo.class 
WIDTH = 350 
HEIGHT = 280> 
</APPLET> 
g 


public class dialogcombo extends JApplet implements ActionListener 


{ 
JButton jbutton = new JButton("Mostrardiálogo"); 


public void inito0 
t 
Container contentpane = getContentPane0; 


public void actionPerformed (ActionEvent e) 
I 
String dialogtitle = nDiálogon; 
String dialogmessage = "¿Cuál le gusta más?"; 
String[] ciesserts = C 
"tarta de queso", "helado", nmousse", "pastel" 
1; 


String dessert = (String)JOptionPane.showInputDialog( 
dialogcombo.this, dialogmessage, dialogtitle, 
JOptionPane.QUESTION-MESSAGE, null, 
desserts, desserts[0l1); 


if ( desaert == null ) 
showstatus (nPulsóCancelar”); 
else 


showstatus ("Su postre favorito: " + tiessert ); 
1 


La figura 17.8 muestra el resultado de este código, donde puede ver el 
cuadro combinado en el cuadro de diálogo. Cuando el usuario selecciona un 
elemento del cuadro combinado y hace clic sobre Aceptar, el cuadro de 
diálogo se cierra y el elemento seleccionado aparece en la barra de estado del 
applet. 
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Figura 17.8. Un cuadro de diálogo de entrada con un cuadro combinado. 


Crear cuadros de diálogo con panel de 
opciones de marcos internos 


Además de los cuadros de diálogo pesados JOptionPane creados en los 
ejemplos previos, puede crear cuadros de diálogo internos de poco peso que 
aparecen dentro de un contenedor. Aquí tiene los métodos estáticos de 
JOptionPane que puede utilizar para crear estos tipos de cuadro de diálogo: 


. 


showZnternalMessageDialog.Muestra algún mensaje al usuario. 


showZnternalConfirmDialog. Solicita la confirmación a una pregunta 
y recibe una respuesta sí/no/cancelar. 


showZnternalInputDialog. Solicita entrada al usuario. 


showZnternalOptionDialog. Un cuadro de diálogo configurable. 


Aquí tiene un ejemplo en el que se visualiza un cuadro de diálogo de 
mensaje interno en un panel de escritorio cuando el usuario hace clic sobre el 
botón Mostrar diálogo interno. Este es el código: 


import java.awt.*; 
import jJavax.swing.*; 
import java.awt.event.*; 


APPLET 


CODE = optionpaneinternal.class 
WIDTH = 350 
HEIGHT = 280 z 
</APPLET> 
tl 


public class optionpaneinternalextendsJApplet implements ActionListener 


( 


private JButton jbutton = new JButton("MOstrardiálogo interno”); 
JDesktopPane jdesktoppane = new JDesktopPaneo0; 


public void initoO 
I 


Container contentpane = getContentPane0; 


contentPane.add (jbutton, Borderiayfout. So UTTH) 1 
sontentPane., add des ktoppane! 


| button. adähcticnLiatenear i thlajl; 
public void action-erformed(ActionEvente) 
JO~tion~ane.show~nternalMessageDialog( 
jdesktoppane, ";Hola desde Swing!", "Diálogo", 
JO-==““O-P=="“., INFORMATION-MESSAGE); 


1 


La figura 17.9 muestra el resultado, donde puede ver el cuadro de diálogo 
de mensaje interno. Este ejemplo se encuentra en el archivo optionpanein- 
ternal.java del CD. 
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Figura 17.9. Un diálogo de mensaje interno. 


Crear cuadros de diálogo con JDialog 


"Bien", dice el programador novato, "los cuadros de diálogo sencillos 
JOptionPane son muy bonitos, pero quiero crear mis propios cuadros de 
diálogo". "¿Desdecero?", preguntamos. "Desde cero”, dice el PN. "Entonces 
quiere la clase JDialog”, decimos. 

La clase JDialog es la base de los cuadros de diálogo personalizados en la 


Swing. Aquí tiene el diagrama de herencia para esta clase: 


AYAH: Ein OMialog 


La tabla 17.11 muestra los campos de la clase JDialog, la tabla 17.12 sus 
constructores y la tabla 17.13 sus métodos. 


Tabla 17.11. Campos de la clase JDialog. 


Campo Descripción l 


protected AccessibleContext acce- El contexto accesible. 
ssibleContext 


protected JRootPane rootPane El panel raíz. 


protected boolean rootPaneCheck- Determina si el panel raíz se puede 
| ingEnabled comprobar. 


Tabla 17.12. Constructores de la clase JDialog. 


Constructor Descripción 

JDialcg{) Construye un cuadro de diálogo no 
modal. 

JDialog(Dialogowner) Construye un cuadro de diálogo no 
modal con el cuadro de diálogo dado 
como padre. 

JDialog(Dia1ogowner, boolean modal) Construye un cuadro de diálogo mo- 
da1 o no modal, sin título y con el 
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JDialog(Dialog owner, String title) 


JDialog(Dialog owner, String title, 
boolean modal) 


JDialog(Frame owner) 


Constructor Descripción 


cuadro de diálogo indicado como 
padre. 


Construye un cuadro de diálogo no 
modal con el título indicado y con el 
marco indicado como padre. 


Construye un cuadro de diálogo mo- 
dal o no modal con el título indi- 
cado y con el marco padre indicado. 


Construye un cuadro de diálogo no 
modal sin título con el marco espe- 
cificado como padre. 


JDialog(Frame owner, boolean modal) Construye un cuadro de diálogo 


JDialog(Frame owner, String title) 


JDialog(Frame owner, String title, 
boolean modal) 


modal o no modal sin título y con el 
marco indicado como padre. 


Construye un cuadro de diálogo no 
modal con el título indicado y con el 
marco indicado como padre. 


Construye un cuadro de diálogo mo- 
da1 o no modal con el título indicado 
y el marco indicado como padre. 


Tabla 17.13. Métodos de la clase JDialog. 


Método 


protected void addlmpl(Component 
comp, Object constraints, int index) 
protected JRootPane createRoot- 
Pane() 


protected void dialoglnit() 


AccessibleContext getAccessible- 
Contexto 


Container getContentPane0 
int getDefaultCloseOperation() 


Descripción 


Añade hijos a contentpane. 


Llamado por los métodos construc- 
tores para crear el JRootPane prede- 
terminado. 


Llamado por los constructores para 
inicializar la propiedad JDialog. 


Obtiene el AccessibleContext. 


Obtiene el contentpane. 


Obtiene la operación que sucede 
cuando el usuario inicia una opera- 
ción de cierre sobre este cuadro de 
diálogo. 


Método 


Component getGlassPane0 
JMenuBar getJMenuBarO 
JLayeredPane getLayeredPane0 
JRoolPane geiRootPanal) 
protected boolean isRootPaneChe- 
ckingEnabled() 


protected String paramString() 


protected void processKeyEvent 
(KeyEvente ) 


protected void processWindowEvent 


(WindowEvent e) 


void remove(Componentcomp) 


void setContentPane(Containercon- 


tentPane) 


void setDefaultCloseOperation(int 
operation) 


void setGlassPane(Componentglass- 


Pane) 
void setJMenuBar(JMenuBar menu) 


JLayeredPanegetLayeredPane0 


void setLayout(LayoutManager ma- 
nager) 


void setLocationRelativeTo(Compo- 
nent c) 


Descripción 
Obtiene el objeto glasspane para 
este cuadro de diálogo. 


Obtiene la barra de menú asignada 
a este cuadro de diálogo. 


Obtiene el objeto layeredPane para 
este cuadro de diálogo. 


Obtiene el objeto rootPanepara este 
cuadro de diálogo. 


Devuelve true si el panel raíz se 
puede comprobar. 


Obtiene una representación de 
cadena de este JDialog. 


Procesa los eventos de teclado que 
suceden sobre este JDialog. 


Procesa los eventos de ventana de- 
pendiendo del estado de la propie- 
dad defaultCloseOperation. 


Elimina el componente indicado de 
este contenedor. 


Asigna la propiedad contentpane. 


Asigna la operación que sucederá 
por defecto si el usuario cierra el 
cuadro de diálogo. 


Asigna la propiedad glasspane. 


Asigna la barra de menú para este 
cuadro de diálogo. 


Asigna la propiedad layeredPane. 


Asigna la distribución del content- 
Pane. 


Asigna la localización del cuadro de 
diálogo relativa al componente indi- 
cado. 


Método 


protected void setRootPane(JRoot- 
Pane root) 


protected void setRootPaneCheck-i 
ngEnabled(boolean enabled) 


void update(Graphics g) 


Crearemos un ejemplo de cuadro de 


Descripción 


Asigna la propiedad rootPane. 


Devuelvetrue si las llamadasaadd() 
y setLayout() pueden generar una 
excepción. 


Simplemente llama a paint(g). 


diálogo utilizando la clase JDialog. 


En este caso, haremos el cuadro de diálogo modal pasando un parámetro final 


con el valor true al constructor JDialog 
diálogo: Aceptar y Cancelar. Al añadir 


y añadiremos botones al cuadro de 
receptores de acciones a los botones, 


podemos saber qué botón se pulsó y podemos indicarlo en la barra de estado 
del applet. Una vez se ha pulsado un botón, llamamos al método dispose del 


cuadro de diálogo para eliminarlo. Aquí 
que otras ventanas de la Swing, puede 
utilizando su panel de contenidos): 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


de 
<APPLET 
CODE = dialog.class 
WIDTH = 350 
HEIGHT = 280> 
</APPLET> 
27 


public class dialog extends JApplet 


{ 
JLabel jlabel = new JLabel ("H 


Cancelarn); 


JButton jbuttonl = new JEutton (' 
jbutton2 = new JButt~n (“Ac 


tiene el código (observe que al igual 
añadir controles al objeto JDialog 


implements ActionListener 


aga clic sobre el botón Aceptar o 


'Mostrar diálogo"), 
eptar"), 


jbutton3 = new JB~tton (~Cancelar"); 


private JDialog dialog = new JDialog((Fr8me) null, 


"Diálogom, true); 


public void init () 
c 


Container contentpane = getContentPane0; 


Container dialogcontentpane 


Content Pana. set Layout new F 


= dialog.getContentPane (); 


lpowLayornt |} } p 


conteos Pac. ati (buttonli y 
dislogcontastrFPaoó.cv0tLayoat nas FlowLlayroutr (111 


dialopcortentPane. add (jlabel!; 
dialopcontentPane. add (jbuttonaj,; 
dislopcontentPane.add(Jbutton3] i 


fbutconl.addactiontilatenas (Chla]; 
jtuteos2.adlactioniisteser (this); 
jbatros3.addActiontistesner(tbimly 


public void action-erformed(ActionEvente) 
1 
if(e.getSource() == jbuttonl) ( 
dialog.setBound- (200, 200, 200, 120); 
dialog.show() 5 
} alas if ja.gotScourcalí == jbutton) [ 
showStatus ("Hizo clic sobre Aceptar"); 
dialog.dispose0; 
) else if(e.getSource0 == jbutton3) ( 
sho-Status(-“Hizalic sobre Cancelar”); 
dialog.dispose0; 


La figura 17.10 muestra el resultado de este código. Como puede ver, el 
cuadro de diálogo visualiza los botones Aceptar y Cancelar. Si hace clic 
sobre un botón cierra el cuadro de diálogo y aparece un mensaje en la barra de 
estado del applet indicando el botón pulsado. Eso es todo. Este ejemplo se 
encuentra en el archivo dialog.java del CD. 

Observe que el cuadro de diálogo que muestra la figura 17.10 únicamente 
acepta entradas de botón del usuario; para observar un ejemplo más avanza- 
do, consulte el tema siguiente. 
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Figura 17.10. Un cuadro de diálogo JDialog básico. 


Obtener entrada de los cuadros de diálogo crea- 
dos con JDialog 


Puede configurar los cuadros de diálogo creados con la clase JDialog 
como desee; examinaremos un ejemplo en este tema. Aqu, mostraremos un 
campo de texto en el que el usuario puede introducir texto. Si el cuadro de 
diálogo se cierra usando el botón Aceptar, el código mostrará el texto que 
introdujo el usuario en el campo de texto de la barra de estado del applet; en 
cualquier otro caso, si el usuario hizo clic sobre el botón Cancelar, el código 
muestra el mensaje "Seleccionó Cancelar". Aquí tiene el código: 


import jJava.awt.*; 
import Javax.swing.*; 
import java.awt.event.*; 


/* 
<APPLET 
CODE = dialoginput.class 
WIDTH = 350 
HEIGHT = 280> 
<A/PPLET> 
£7 


public class dialoginput extends JApplet implements ~ction~istener 
JLabel jlabel = new JLabel ("1ntroduzcael texto:"); 
JTextField jtextfield = new JTextField(15); 
JButton jbuttonl = new JButton ("Mostrardiálogo") 


jbutton2 new JButton ("Aceptar"), 
jbutton3 = new JButton ("Cancelar"); 


private JDialog dialog = new JDialog((Frame) null, 
"Diálogo", true); 


public void init () 
t 
Container contentpane = getContentPane0; 
Container dialogcontentpane = dialog.getContentPane0; 


contentPane.setLayouti¡new FlilowLlayout ibi 
contant Pans. adä i ibottoni)} 7 


dlalogcontentPabé. Batiayout (new FlowLayoat i) ) g 
dislopcontentPañe.,addijlabal!;, 


dialopcortentrine.add(jtentiisld); 
dia logcontentPane., add (Jbuttondi; 


dlslogcontan trans. add (fbuttosJ)r 


ibuttonl.,sddiccionLiateñnar [cbla!p 
ibueteni.addñictiontistener/tbis)p 
jbutton3.sddActiontisteaner¡etbla); 


public void actionPerformed (ActionEvent e) 
( 

if (e.getSource0 == jbuttonl) i 
dialog.set-ounds (200, 200, 200, 150); 
dialog.show0; 

) else if(e.getSource0 == jbutton1) I 
showr"tatus (jtextfield.getTexto l; 
dialog.dispoie0; 

> eise if(e.getsource0 == jbutton3) (C 

show-tatus (“Iliizalic sobre Cancelar”); 
dialog.dispose0; 


) 


La figura 17.11 muestra el resultado de este código, donde puede ver el 
cuadro de diálogo con el campo de texto. Cuando el usuario introduce texto y 
hace clic sobre Aceptar, el texto aparece en la barra de estado del applet. Es 
todo. Este ejemplo se encuentra en el archivo dialoginput.java del CD. 


Figura 17.11. Un cuadro de diálogo JDialog con un campo de texto. 
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m Swing: tablas 
y arboles 
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En este capítulo, examinaremos dos de los componentes más importantes 
de la Swing: tablas y árboles. Ambos temas tienen un ámbito muy grande y 
requerirían un volumen entero por sí mismos. Puede adivinar su función por 
sus nombres. Las tablas presentan al usuario datos en una forma tabular y los 
árboles muestran datos jerárquicos en una forma que ha pasado a ser común: 
usando nodos expandibles. Antes de profundizar en estos temas, veremos un 

breve resumen de cada uno. 


Tablas 


Las tablas pueden ser el componente más complejo en la Swing. De 
hecho, se dedica un paquete completo a ellas: swing.table. Las tablas presen- 
tan y permiten al usuario editar datos distribuidos en filas y columnas. En la 
Swing, las tablas están compuestas por cabeceras de columna y objetos co- 
lumna. Por supuesto, también puede manejar los datos por filas y por celdas 
individuales, aunque estas construcciones no son objetos. 

Las tablas de la Swing son muy flexibles, y por esta misma razón son muy 
complejas. Puede editar los datos en la tabla directamente y utilizar varios 
modos de selección (incluyendo columna, fila y selección de celda indivi- 
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dual). Puede utilizar su propio modelo de columnas y cabeceras de columna, 
tablas decoradas, dibujar sus propias celdas derivando un nuevo renderizador 
de celda a partir de la interfaz TableCellRenderer, manejar la edición de 
celdas implementando la interfaz CellEditor, usar acciones de pulsaciones de 
teclas, reordenar columnas, cambiar el tamaño de columnas y mucho más. 

Como con otros componentes dela Swing, puede personalizar casi todo en 
una tabla y debido a que involucra muchos subcomponentes, la parte el 
proceso de personalización puede llegar a ser muy compleja. 


Arboles 


Uno de los dos componentes en la programación IU que permite al usuario 
manejar datos es el árbol. Si ha utilizado el explorador de Microsoft Windows, 
ya conocerá los árboles; esta utilidad presenta una estructura de directorio 
usando un árbol. Los árboles utilizan la analogía de "carpetas y hojas" para 
presentar los datos; cuando hace doble clic sobre una carpeta visible, apare- 
cen las páginas (u hojas), asícomo cualquiera de sus carpetas dependientes. 
También puede cerrar las carpetas de nuevo haciendo doble clic sobre ellas. 
Los árboles distribuyen sus datos en una jerarquía vertical, conectada con 
líneas, facilitando su presentación desplazable. A veces también se utilizan 
para visualizar directorios (como carpetas) y archivos (como hojas) de una 
forma manejable. 

Como las tablas, los árboles son suficientemente complejos como para 
tener su propio paquete en la Swing: swing.tree. En términos de programa- 
ción, los árboles están compuestos de nodos y cada nodo puede ser una 
carpeta o una hoja. Las carpetas pueden tener nodos hijos. Todos los nodos 
excepto el nodo raíz tienen un único nodo padre. Como puede suponer, la 
presentación de las carpetas y hojas depende de la apariencia. Cuando abre 
una carpeta, se considera expandida y cuando la cierra, se colapsa. Como con 
las tablas, puede personalizar los árboles con sus propios renderizadores y 
editores. En este capítulo obtendrá una buena introducción al tema. 

Esto es suficiente como resumen de lo que aparece en este capítulo. 
Vendrá mucho más: las tablas y los árboles representan una cantidad enorme 
de profundidad de programación. 


Crear tablas 


El gran jefe aparece y dice, "Sobre el nuevo programa de hoja de cálculo 
que está escribiendo...” "No sabía que estuviera escribiendo nada de eso", 


decimos. "No interrumpa", dice el gran jefe. "Lo necesitábamos ayer. ¿Está 
hecho?" "Mmh", decimos, "parece un trabajo para la clase JTable". 
JTable es el componente de la Swing que presenta los datos en un formato 
de tabla bidimensional. Aquí tiene el diagrama de herencia para JTable: 
java.lang.Object 
| 


+3 ava. awt . Component 


+-java.awt.Container 


La tabla 18.1 muestra los campos de la clase JTable, la tabla 18.2 sus 
constructores y la tabla 18.3 sus métodos (observe lo extensa que es ésta 
clase). 


Tabla 18.1. Campos de la clase JTable. 


Descripción 
static int AUTO-RESIZE-ALL-COLUMNS Cambio de tamaño de la co- | 


lumna durante las opera- 
ciones de cambio de tamaño. 


static int AUTO-RESIZE-LAST-COLUMN También la última columna 
únicamente durante todas las 
operaciones de cambio de 
tamaño. 


static int AUTO-RESIZE-NEXT-COLUMN Cuando una columnase ajus- 
ta, este campo ajusta la si- 
guiente, de forma opuesta. 


static int AUTO-RESIZE-OFF Utiliza una barra de desplaza- 
miento para ajustar el ancho 
de columna. 

static int AUTO-RESIZE-SUBSEQUENT- Cambia lascolumnas siguien- 

COLUMNS tes para preservar el ancho 
total hasta el cambio de tama- 
ño. 

protected boolean autoCreateColumns- Para crear el conjunto de co- 

FromModel Consulta el TableModel lumnas predeterminado si es- 


te campo es true. 


protected int autoResizeMode Asignasilatablacambia auto- 
máticamente el tamaño de la 


Descripción 


anchurade sus columnas pa- 
ra ocupar el ancho total de la 
tabla. 


protected TableCellEditor cellEditor Un objeto que sobrescribe la 
celda actual y permite al 
usuario cambiar sus conteni- 
dos. 


protected boolean cellSelectionEnabled Siestrue, tantolas filas como 
las columnas seleccionadas 
puedenconfigurarseal mismo 


tiempo. 
protected TableColumnModel columnModel El TableColumnModel de la 
tabla. 
protected TableModel dataModel El TableModel de la tabla. 
protected Hashtable defaultEditorsByCo-  Latabla de objetos que visua- 
lumnClass liza y edita el contenido de 
una celda, con índice por cla- 
se. 


protected Hashtable defaultRenderersBy-  Latabla deobjetosquevisua- 
ColumnClass liza el contenidode una celda, 
con índice por clase. 


protected int editingcolumn La columna de la celda en 
edición. 

protected int editingRow La fila de celda editada. 

protected Component editorcomp El componente que procesa 
la edición. 

protected Color gridcolor El color de rejilla. 


protected Dimension preferredviewportsize Utilizado por la interfaz Scro- 
llable para determinar el área 


inicial visible. 

protected int rowHeight La altura de las filas en la 
tabla. 

protected int rowMargin La altura de las imágenes de 
filas. 

protected boolean rowSelectionAllowed Devuelve true si se permite 


selecciónde fila en esta tabla. 


Descripción 


protected Color selectionBackground Elcolor de fondo de las celdas 
seleccionadas. 


protected Color selectionForeground El color de primer plano de 
las celdas seleccionadas. 


protected ListSelectionModel selectionModel El ListSelectionModel de la 
tabla; se utiliza para controlar 
las filas seleccionadas. 


protected boolean showHorizontalLines Las líneas horizontales se di- 
bujan entre las celdas cuando 
este campo es true. 


protected boolean showVerticalLines Las líneas verticales se di- 
bujan entre las celdas si este 
campo es true. 


protected JTableHeader tableHeader El JTableHeader que funcio- 
na con la tabla. 


Tabla 18.2. Constructores de la clase JTable. 


Constructor Descripción 

JTable() Construye un JTable prede- 
terminado. 

JTable(int numRows, int numColumns) Construye un JTable con 


numRows y numColumns de 
celdas vacías. 


JTable(Object[][] rowData, Object[] column- Construye un JTable para vi- 

Names) sualizar los valores en una 
matriz bidimensional, rowDa- 
ta, con nombres de columna 
columnNames. 


JTable(TableMode1 dm) Construye un JTable iniciali- 
zado condm como modelo de 
datos, un modelo de columna 
predeterminado y un modelo 
de selección predeterminado. 


JTable(TableMode1dm, TableColumnModel Construye un JTable inicia- 

cm) lizado con dm como modelo 
de datos, cm como modelo de 
columna y un modelo de se- 
lección predeterminado. 


Constructor Descripción 


JTable(TableModetdm, TableColumnModel Construye un JTable iniciali- 
cm, ListSelectionModel sm) zado con dm como modelo 
de datos, cm como modelo de 
columnas y m como modelo 


de selección. 
JTable(Vector rowData, Vector column- Construye un JTable para vi- 
Names) sualizarlos valores en el vec- 


tor de Vectores, rowData, con 
nombres de columna dados 


en columnNames. 
— 


Tabla 18.3. Métodos de la clase JTable. 


Método Descripción 


void addColumn(TableColumn aColumn) Añade la columna al final de 
la matriz de columnas. 


void addColumnSelectionInterval(intindex0, Añade las columnas desde 


intindexl) indexOa indexl, incluida, a la 
selección. 

void addNotify () Llama a configureEnclosing- 
ScrollPane. 

void addRowsSelectionInterval(int index0, Añade las filas desde indexO 

int indexl) a indexl, incluida, a la se- 
lección. 

void clearSelection() Deselecciona todas las co- 
lumnas y filas seleccionadas. 

void columnAdded(TableColumnModel- Indica a los receptores que 

Event e) una columna hasido añadida 
al modelo. 

int columnAtPoint(Point point) Obtiene el índice de la co- 


lumna en que point reside (ó 
-1 siresidefuera de los límites 
del receptor). 


void columnMarginChanged(ChangeEvente) Notifica a los receptores que 
una columna se ha movido 
debido al cambio de imáge- | 
nes. l 


Método 


Descripción 


void columnMoved(TableColumnModel- 
Event e) 


void columnRemoved(TableColumnModel- 
Event e) 


voidcolumnsSelectionChanged(ListSelection- 


Event e) 


protected void configureEnclosingScroll- 
Pane() 


int convertColumnIndexToModel(int view- 
Columnindex) 


int convertColumnIndexToView(int model- 
Columnindex) 


protected TableColumnModel createDe- 
faultColumnModel() 


void createDefaultColumnsFromModel() 


protected TableModel createDefaultData- 
Modelo 


Notifica a los receptores que 
una columna cambia de posi- 
ción. 

Notifica a los receptores que 
una columna fue eliminada 
del modelo. 


Notifica a los receptores que 
el modelo de selección de Ta- | 
bleColumnModel ha cambia- 
do. 


Configura los JScrollPane 
contenidos instalando el ta- 
bleHeaderdelatabla, column- 
HeaderView del panel de 
desplazamiento y así 
sucesivamente. 


Obtiene el índice de la co- 
lumna en el modelo cuyos da- 
tos se muestranen lacolumna 
viewColumnindexde la panta- 
lla. 


Obtiene el índice de la co- 

lumna en la vista que muestra 
los datos desde la columna 
modelColumnindexdelmodelo. 


Obtiene el modelo de objeto 
de columna predeterminado, 
que es un DefaultTableCo- 
lumnModel. 


Crea columnas predetermi- 
nadas para la tabla partir del 
modelo de datos utilizandolos 
métodos getColumnCount() y 
getColumnClass() definidos 
en la interfaz TableModel. 


Obtiene el modelo de objetos 
de la tabla por defecto, que 
es un DefaultTableModel. 
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Método 


protected void createDefaultEditors() 


protected void createDefaultRenderers() 


protected ListSelectionModel createDe- 
faultSelectionModel() 


protected JTableHeader createDefault- 
TableHeader() 


static JScrollPane createScrollPaneFor- 
Table(JTable aTable) 


boolean editCellAt(int row, int column) 
boolean editCellAt(introw, int column, Event 
Object e) 

void editingCanceled(ChangeEvente) 


void editingStopped(ChangeEvent e) 


AccessibleContext getAccessibleContext() 


boolean getAutoCreateColumnsFromModel() 


int getAutoResizeMode() 


TableCelEditor geiCallEditor[) 


Descripción 


Crea editores de celdas pre- 
determinados para objetos, 
números y valores boolean. 


Crea renderizadores prede- 
terrminados. 


Obtiene el modelo de se- 
lección de objetos predeter- 
minado, que es un DefaultList- 
SelectionModel. 


Obtiene el objeto cabecera 
de tabla predeterminado, que 
es un JTableHeader. 


Obsoleto. Reemplazado por 
el nuevo new JScrollPane 
(aTable). 


Inicia la adición en la fila | 
situada en row y column, si la | 
celda se puede editar. 


Inicia la edición de la celda 
row y column, si la celda se 
puede editar. 


Llamado cuando se cancela 
la edición. 


Llamado cuando termina la 
edición. 
Obtiene el AccessibleContext 


asociado con este JCompo- 
nent. 


Obtiene si la tabla creara 
columnas predeterminadas a 
partir del modelo. 


Obtiene el modo de cambio | 
de tamaño automático de la 
tabla. 


Obtiene el cellEditor. 


| Método 


Descripción 


TableCellEditor getCellEditor(int row, int 
column) 


Rectangle getCellRect(introw, int column, 
boolean includespacing) 
TableCellRenderergetCellRenderer(int row, 
int column) 


boolean getCellSelectionEnabled() 


TableColumn getColumn(0bject identifier) 


Class getColumnClass(int column) 


int getColumnCount() 


TableColumnModel gelColumnModel() 


String getColumnName(int column) 


boolean getColumnSelectionAllowed() 


TableCellEditor getDefaultEditor(Class 
columnClass) 


Obtiene el editor adecuado 
para la celda dada por su 
columna y fila. 


Obtiene un rectángulo que lo- 
caliza la celda que reside en | 
la intersección de fila y co- 
lumna. 


Obtiene un renderizador ade- 
cuado para la celda dada su 
fila y columna. 


Devuelve true si se permiten 
selecciones simultáneas de 
fila y columna. 


Obtiene el objeto TableCo- 
lumn para la columna en la 
tabla cuyo indicadorsea igual 
a identifier, cuando se com- 
para utilizando equals(). 


Obtiene el tipo de columna en 
una posición de la vista dada. 


Obtiene el número de co- 
lumnas del modelo de co- 
lumna (observe que éste pue- 
de ser distinto del número de 
columnas en el modelo de la 
tabla). 


Obtiene el TableColumnMo- 
del que contiene toda la 
información de columnas de 
esta tabla. 


Obtiene el nombre de la 
columna en una posición de 
vista dada. 


Devuelve true si se pueden 
seleccionar columnas. 


Obtiene el editor que se debe 
utilizar cuando no se ha confi- 


Método 


TableCellRenderer getDefaultRenderer 
(Class columnClass) 


int getEditingColumn() 

int getEditingRow() 

Component getEditorComponent() 
Color getGridColor() 

Dimension getintercellSpacing() 


TableModel getModel() 


Dimension getPreferredScrollableViewport- 
Size() 

int getRowCount() 

int getRowHeight0 

int getRowMargin() 


boolean getRowsSelectionAllowed() 


intgetScrollableBlockIncrernent(Rectangle 
visibleRect, int orientation, int direction) 


Descripción 


gurado ningún editor en un 
TableColumn. 


Obtiene el renderizador que 

se debe utilizar cuando no se 
ha seleccionado un renderi- 
zador en un TableColumn. 


Obtiene el índice de la co- 
lumna en edición. 


Obtiene el índice de la fila en 
edición. 

Obtiene el componente que 
devolvió el CellEditor. 


Obtiene el color utilizado para 
dibujar las líneas de rejilla. 


Obtiene el espaciamientover- 
tical y horizontal entre celdas. 


Obtiene el TableModel que! 
proporcionalos datos mostra- 
dos por el receptor. 


Obtiene el tamaño preferido 
del Viewport para esta tabla. 


Obtiene el número de filas en 
la tabla. 


Obtiene la altura de una fila 
de la tabla en el receptor. 


Obtiene la cantidad de espa- 
cio libre entre filas. 


Devuelve true si se pueden 
seleccionar filas. 


Obtiene el visibleRect.height 
o visibleRect.width, depen- 
diendo de la orientación de la 
tabla. 


boolean getScrollableTracksViewportHeight() [Tevuelvetrue si la altura del 


Viewport no determina la 
altura de la tabla. 


Método 


Descripción 


boolean getScrollableTracksViewportWidth() 


int getScrollableUnitIncrement(Rectangle 
visibleRect, int orientation, int direction) 


int getSelectedColumn() 


int getSelectedColumnCount() 


int[] getSelectedColumns() 


int getSelectedRow() 


int getSelectedRowCount() 
int[] getSelectedRows() 
Color getSelectionBackgrouna() 


Color getSelectionForeground() 


ListSelectionModel getSelectionModel() 


boolean getShowHorizontalLines() 


boolean getShowVerticalLines() 


Devuelve true si la anchura 
del Viewport no determina la 
anchura de la tabla. 


Obtiene el incrementode des- 
plazamiento que expone 
completamenteuna nueva fila 
o columna. 


Obtieneel índice de la primera 
columna seleccionada ó -1 si 
no hay columnas seleccio- 
nadas. 


Obtiene el número de 
columnas seleccionadas. 


Obtiene los índices de todas 
las columnas seleccionadas. 


Obtieneel índice de la primera 
fila seleccionada ó -1 si no 
existen filas seleccionadas. 


Obtiene el número de filas | 
seleccionadas. 


Obtiene los índices de todas 
las filas seleccionadas. 


Obtiene el color de fondo para 
las celdas seleccionadas. 


Obtiene el color de primer 
plano para las celdas seleccio- 
nadas. 


Obtieneel ListSelectionModel 
que se utiliza para mantener 
el estado de selección de fila. 


Devuelve true si el receptor 
dibuja líneas horizontales 
entra las celdas y false si no 
es así. 


Devuelve true si el receptor 
dibuja líneas verticales entre 
las celdas y false si no es así. 


Método 


JTableHeader getTableHeaderO 


String getToolTipText(MouseEvent event) 


TableLll get) 
String getUlClassID() 


Object getValueAt(int row, int colurnn) 


protected void initializeLocalVars() 


boolean isCellEditable(int row, int colurnn) 


boolean isCellSelected(int row, int colurnn) 
boolean isColurnnSelected(intcolurnn) 


boolean isEditing() 
boolean isManagingFocus() 


boolean isRowSelected(int row) 


void rnoveColurnn(intcolurnn, int target- 
Colurnn) 


Descripción 


Obtiene el tableHeader que | 
trabaja con este JTable. | 


Sobrescribe el método 
setToolTipText de JCornpo- 
nent y permite el uso de 
ayudas de herramientas del 
renderizador (si el rende- 
rizador tiene texto asignado). 


Obtiene el objeto apariencia 
que renderiza este cornpo- 
nente. 


Obtiene el nombre de la 
apariencia que renderiza este 
componente. 


Obtiene el valor de la celda 
en row y colurnn. 


Inicialas propiedadesdetabla 
con sus valores predeterrni- 
nados. 


Devuelve true si la celda en 
row y colurnn puede editarse. 


Devuelve true si la celda en 
una posición dada está se- 
leccionada. 


Devuelve true si la columna 
en un índice dado esta se- 
leccionada. 


Devuelve true si la tabla está 
editando una celda. 


Sobrescrito para devolver 
true. 


Devuelve true si la fila en una 
posición dada está seleccio- 
nada. 


Mueve la columna colurnn a 
la posición ocupada actual- 


Método Descripción 
mente por la columna target- | 


Column. 


protected String paramString() Obtiene una representación 
de cadena de esta JTable. 


Component prepareEditor(TabteCellEditor Prepara el editor dado utili- 


editor, int row, int column) zando el valor de la celda da- 
da. 

Component prepareRenderer(TableCel1- Prepara el renderizador dado 

Renderer renderer, int row, int column) con un valor adecuado del 
dataModel. 


void removeColumn(TableColumnaColumn) Elimina una columna de la 
matriz de columnas del JTa- 


ble. 
void removeColumnSelectionInterval(int Deselecciona las columnas 
indexo0, int indexl) desde indexO a indexl, inclu- 
sive. 
void removeEditor() Descarta el objeto editor. 
void removeRowsSelectioninterval(intindex0, Elimina la selección desde 
int indexl) indexO a indexl, para filas, 
inclusive. 


void reshape(intx, int y, int width, int height)  Llamaa super.reshape() y es- 
tá sobrescrito para detectar 
cambios en los límites de la 


tabla. 

protected void resizeAndRepaint() Equivalente a revalidateo 
seguido por repaint(). 

int rowAtPoint(Point point) Obtiene el índice de la fila 
sobre el cual se sitúa el punto 
point. 

void selectAll() Selecciona todas las colum- 
nas, filas y celdas en la tabla. 

void setAutoCreateColumnsFromModel Asignael indicador autocrea- 

(boolean createColumns) teColumnsFromModel de la 
tabla. 

void setAutoResizeMode(int mode) Asigna el modo de cambio de 


tamaño automáticode latabla 
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Método Descripción 


cuando ésta cambia de | 
tamaño. 


void setCellEditor(TableCellEditor anEditor) Asigna la variable cellEditor. 


void setCellSelectionEnabled(boolean flag) Asigna si esta tabla permitirá | 
tanto selección de filas como | 
de columnas al mismo tiempo. 


void setColumnModel(TableColumnModel Asigna el modelo de columna 
newModel) para esta tabla a newModel y 
registra receptores de notifi- 
cación para el nuevo modelo 


de columna. 
void setColumnsSelectionAllowed(boolean Asigna que columnas de este 
flag) modelo se puedan seleccio- 
nar. 


void setColumnSelectionInterval(intindex0, Seleccionalas columnasdes- 
intindexl) de indexO a indexl incluido. 


void setDefaultEditor(Class columnClass,  Asigna el editor predetermi- 

TableCellEditor editor) nado que debe utilizarse si no 
se asigna un editor a un 
TableColumn. 


void setDefaultRenderer(ClasscolumnClass, Asigna un renderizador pre- 

TableCellRenderer renderer) determinado que se utilizará 
si no se asigna un renderiza- 
dor a TableColumn. 


| void setEditingColumn(int aColumn) Asigna la variable editingco- 
lumn. 

void setEditingRow(int aRow) Asignala variable editingRow. 

void setGridColor(Color newcolor) Asigna el color utilizado para 


dibujar las líneas de rejilla a | 
newColory visualizade nuevo 


el receptor. 
void setintercellSpacing(Dimensionnew- Asigna la anchura y altura 
Spacing) entre celdas a newspacingy 


dibuja de nuevo el receptor. 


void setModel(TableModel newModel) Asigna el modelo de datos 
para esta tabla a newModel y 
registra los receptores de 
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Método Descripción 


modificaciones para el nuevo 
modelo de datos. 


void setPreferredScrollableViewportSize Asigna el tamaño preferido 


| (Dimension size) del Viewport para esta tabla. 
| void setRowHeight(int newHeight) Asigna la altura de filas. 
void setRowMargin(int rowMargin) Asigna la cantidad de espacio 


libre entre filas. 


void setRowsSelectionAllowed(booleanflag) Asigna si las filas de este 
| modelo se pueden seleccio- 


nar. 
void setRowsSelectionInterval(int index0, int Selecciona las filas desde in- 
indexl) dexO a indexl inclusive. 

void setSelectionBackground(Color selec- Asigna el color de fondo para 
tionBackground) las celdas seleccionadas. 
void setSelectionForeground(Color selec- Asigna el color de primer pla- 
tionForeground) no para las celdas seleccio- 

nadas. 


void setSelectionMode(int selectionMode) Asigna el modo de selección 
de tabla para permitir se- 
lección simple, un intervalo 
simple continuo o intervalos 


múltiples. 
void setSelectionModel(ListSelectionModel Asignaelmodelo de selección 
newModel) defilas para esta tabla a new- 
Model. 
void setShowGrid(boolean b) Asigna si se dibujan líneas de 


rejilla alrededor de las celdas. 


void setShowHorizontalLines(boolean b) Asigna si se dibujan líneas 
horizontales entre celdas. 


void setShowVerticalLines(boolean b) Asigna si se dibujan líneas 
verticales entre celdas. 


void setTableHeader(JTab1eHeademew- AsignaeltableHeaderquetra- 


Header) baja con estatabla a newHea- 
der. 
void setUl(TableU1 ui) Asignaelobjetoaparienciaque 


renderiza este componente. 


Método Descripción 


void setValveAd Object aWalue, int row, int Asigna el valor para la celda 
column) en row y column. 


| void sizeColumnsToFit(boolean lastColumn Obsoleto. Reemplazado por 
| Oniyi sizeColumnsToFit(int). 


void sizeColumnsToFit(int resizingcolumn) Cambia el tamaño de una o 
más columnas en la tabla para 
que la anchura total de todas 
las columnas del JTable sea 
igual a la anchura de la tabla. 


void tableChanged(TableModelEvente) Llamado cuando se cambia 
la tabla. 


void updateUl() Llamado por UlManagercuan- 
do cambia la apariencia. 


void valueChanged(ListSelectionEvente) Invocado cuando cambia la 
selección. 


El modelo utilizado para contener los datos en una tabla deriva de la clase 
AbstractTableModel. 

El modelo de tabla predeterminado es la clase DefaultTableModel. Aquí 
tiene el diagrama de herencia para esta clase: 


java.lang-Object 
+-javax.swing.table.-bstractTableModel 


l 


+-javax.swing.table.DefaultTableModel 


La tabla 18.4 muestra los campos de la clase DefaultTableModel, la tabla 
18.5 muestra sus constructores y la tabla 18.6 sus métodos. 


Tabla 18.4. Campos de la clase Default TableModel. 
Descripción 


protected Vector columnldentifiers Un vector de identificadores 
de columna. 


protected Vector datavector Un vector de valores Object. 


Tabla 18.5. Constructores de la clase DefaultT ableModel. 


Constructor Descripción 
DelauitTabloModal() Construye un DefaultTable- 
Model. 
DefaultTableModel(int numRows, int num- Construye un DefaultTable- 
Columns) Model con numRows y num- 
Columns. 
DefaultTableModel(Object[][data, Object[] Construye un DefaultTable- 
columnNames) Model e inicia la tabla pasando 


data ycolumnNames al méto- 
do setDataVector(). 


DefaultTableModel(Object[]columnNames, Construye un DefaultTable- 

int numRows) Model que tiene tantas co- 
lumnas como elementos o 
valores nulos de objetos en 
columnNames y numRows. 


DefaultTableModel(Vector columnNames, Construye un DefaultTable- 

int numRows) Model con tantas columnas 
como elementos existan o va- 
lores de objeto nulos en 
columnNames y numRows. 


DefaultTableModel(Vector data, Vector Construye un DefaultTable- 

columnNames) Modele inicia la tabla pasando 
data y columnNames al mé- 
todo setDataVector(). 


Tabla 18.6. Métodos de la clase DefaultTableModel. 


Metodo Descripción 


void addColumn (Object columnName) Añade una columna al mode- 
lo. 

void addColumn(Object columnName, Añade una columna al modelo 

Object[] columnData) con el nombre columnName. 

void addColumn(ObjectcolumnName, Añade una columna al mo- 

Vector columnData) delo. 

void addRow(Object[] rowData) Añade una fila al final del 
modelo. 

void addRow(Vector rowData) Añade la fila al final del mode- 
lo. 


Método 


protected static Vector convertToVector 
(Object[] anArray) 


protected static Vector convertToVector 
(Object[][] anArray) 


int getColumnCount() 
String getColumnName(int column) 


Vector getDataVectorO 


int getRowCount() 

Object getValueAt(int row, int column) 
void insertRow(int row, Object[] rowData) 
void insertRow(int row, Vector rowData) 
boolean isCellEditable(int row, int column) 


void moveRow(int startindex, int endlndex, 
inttolndex) 


void newDataAvailable(TableModelEvent 
event) 


| voidnewRowsAdded(TableModelEvent 
event) 


void removeRow(int row) 


void rowsRemoved(TableModelEventvent) 


Descripción 


Obtiene un Vectorque contie- 
ne los mismos objetos que la 
matriz. 


Obtiene un Vector de Vecto- 
res que contiene los mismos 
objetos que la matriz. 


Obtiene el número de co- 
lumnas en estatabla de datos. 


Obtiene el nombre de co- 
lumna. 


Devuelve el vector de Vecto- 
res que contiene los valores 
de datos de la tabla. 


Obtiene el número de filas en 
esta tabla de datos. 


Obtiene un valor de atributo 
para la celda en rowycolumn. 


Inserta una fila en row en el 
modelo. 


Inserta una fila en row en el 
modelo. 


Devuelve true si la celda en 
row y column se puede editar. 


Mueve una o más filas co- 
menzando desde startindex 
hasta endindex en el modelo 
hasta tolndex. 


Equivalente a fireTableChan- 
ged. 


Este método permite asegurar 
que las nuevas filas tienen el 
númerocorrectode columnas. 


Elimina la fila en row del mo- 
delo. 


Equivalente a fireTableChan- 
WdO. 


Método 


void setColumnldentifierc(Object[] 
newldentifiers) 


void setColumnldentifiers(Vector newlden- 
tifiers) 


void setDataVector(Object[][] newData, 
Object[] columnNames) 


void setDataVector(Vector newData, 
Vector columnNames) 


void setNumRows(int newSize) 


void setValueAt(Object avalue, int row, 
int column) 


Descripción 


Reemplaza los identificadores 
de columna del modelo. 


Reemplazalos identificadores 
de columna del modelo. 


Reemplazael valorde lavaria- 
ble de instancia datavector 
con los valores de la matriz 
newData. 


Reemplaza la invariable de 
instancia actual datavector 
con los nuevos rectores de fi- 
las, newData. 


Asigna el número de filas del 
modelo. 


Asigna el valor del objeto para 
row y column. 


Aunque la clase JTable es compleja, proporciona valores predeterminados 
para la mayoría de los aspectos de la programación de tablas, facilitando las 


cosas. Aquí tiene un ejemplo en el que utilizam 


os la clase DefaultTableModel 


para añadir datos a una tabla, fila por fila. Primero, creamos un nuevo objeto 
de la clase DefaultTableModel y un nuevo objeto JTable que visualiza los 


datos en ese modelo de objeto: 


import Java.awt.*; 
import javax.swing.*; 
import javax.swing.table.*; 


> 
<APPLET 
CODE = table.class 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
liv 


public class table extends JApplet 


{ 
DefaultTableModel defaulttablemodel = 


new DefaultTableModel (); 


JTable jtable = new JTable (defaulttablemodel); 


A continuación, utilizamos el método addcolumn del modelo de tabla 
predeterminado para añadir columnas a la tabla, proporcionando los títulos 
Columna 0, Columna 1 y así sucesivamente: 


public class table extends JApplet 


( 
DefaultTableModel defaulttablemodel = new DefaultTableModel (); 


JTable jtable = new JTable (defaulttablemodel); 


public void initO0 


1 
for(int col- = 0; column < 5; col—++)( 
defaulttablemodel .addColumn (nColumna "4 column) ; 


Una vez añadidas las columnas a la tabla, estamos listos para añadir los 
datos que la tabla mostrará en sus filas y lo haremos construyendo cada fila y 
después utilizando el método addRow del modelo. Cada fila es una matriz de 
objetos; en este caso, utilizaremos objetos String. Aquí tiene el mecanismo 
de construcción de cada fila y la forma de añadirla a la tabla: 


public class table extends JApplet 


{ 
Object [l data = new Object 1515 


DefaultTableModel defaulttablemodel = new DefaultTableModel (); 
JTable jtable = new ~~able (defaulttablemodel1); 


public void init () 
i 
for(int column = 0; column < 5; column++)( 
defaulttablernodel.addColumn (~~Columna + column); 


for(int row = 0; row < 10; row++) { 
for(int column = O; column < 5; col—+) { 
data[column] = "Celda "+ row + e + column; 


1 
defaulttablemodel .addRow (data) ; 


Lo único que resta es visualizar la nueva tabla. Las tablas normalmente se 
muestran en paneles de desplazamiento y, de hecho, debería hacerlo de esa 
forma para estar seguro de que aparecen las cabeceras de columna. Aquí tiene 
la forma de añadir la tabla a un JScrollPane y después mostrarla: 


public class table extends JApplet 
Object [] data = new Objectt51; 


DefaultTableModel defaulttablemodel = new DefaultTable-odel (); 
JTable jtable = new JTable (defaulttablemodel); 


public void init() 
I 
for (int column = 0; column < 5; colurnn++)( 
defaulttablemodel.addColumn ("Columna " + column); 


for(int row = 0; row < 10; row++) ( 
for (int column = O; column < 5; column++) ( 
data[columnl = "Celda "+ row + ","+ column; 


1 
defaulttablemodel.addRow (data); 
1 
getContentPaneO0.add (new JScrollPane (jtable)); 


Crear árboles 


"Oh", dice el programador novato, "el gran jefe quiere que cree una utili- 
dad de directorio de archivos que muestre archivos y directorios utilizando un 
árbol”. "Bien", decimos, "puede utilizar un árbol". "Fantástico", dice el 
programador novato. "Una cosa, ¿qué es un árbol?" 

Los árboles son controles que muestran datos jerárquicos como un esque- 
ma basado en nodos. Un nodo específico puede quedar identificado bien por 
un TreePath (un objeto que encapsula un nodo y todos los nodos de que 
desciende; llamados ancestros) o por su fila visualizada (la fila en pantalla 
muestra únicamente un nodo). Puede expandir nodos para visualizar todos 
sus hijos. Uno nodo colapsado es el que oculta sus hijos y un nodo oculto es 
el que queda colapsado por su padre. Los árboles están soportados en la 
Swing por la clase JTree. Aquí tiene el diagrama de herencia para esta clase: 


Pà 


La tabla 18.7 muestra los campos de la clase JTree, la tabla 18.8 muestra 
sus constructores y la tabla 18.9 sus métodos. 


Tabla 18.7. Campos de la clase JTree. 


Descripción 


static String CELL-EDITOR-PROPERTY El nombre de la propiedad | 
ligada para cellEditor. 


static String CELL-RENDERER-PROPERTY El nombre de la propiedad 
ligada para cellRenderer. 


protected TreeCellEditor cellEditor El editor para las entradas. 


protected TreeCellRenderer cellRenderer El renderizador de celda utili- 
zado para dibujar los no- 


dos. 

protected boolean editable Devuelve true si el árbol es 
editable. 

static String EDITABLE-PROPERTY El nombre de la propiedad 
ligada para editable. 

static String INVOKES-STOP-CELL- El nombre de la propiedad 
ligada para messagesstop- 

EDITING-PROPERTY CellEditing. 


protected boolean invokesStopCellEditing Devuelve true cuando se de- 
tiene la edición. 


static String LARGE-MODEL-PROPERTY El nombre de la propiedad li- 
gada para largeModel. 


protected boolean largeModel Devuelvetrue si el árbol utiliza 
modelo largo. 


static String ROOT-VISIBLE-PROPERTY Elnombrela propiedad ligada 
para rootvisible. 


protected boolean rootvisible Devuelve true si el nodo raíz 
se visualiza y falce si sus hijos 
sonlos nodosvisibles superio- 
res. 


static String ROW-HEIGHT-PROPERTY El nombre de la propiedad li- 
gada para rowHeight. 


protected int rowHeight La altura utilizada por cada 
fila visible. | 


Descripción 


static String SCROLLS-ON-EXPAND- 
PROPERTY 


protected boolean scrollsOnExpand 


static String SELECTION-MODEL-PRO- 
PERTY 


protected TreeSelectionModel selection 
Model 


protected JTree.TreeSelectionRedirector 
selectionRedirector 


static String SHOWS-ROOT-HANDLES- 
PROPERTY 


protected boolean showsRootHandles 


protected int toggleClickCount 
static String TREE-MODEL-PROPERTY 
protected TreeModel treeModel 


protected TreeModelListenertreeModel- 
Listener 


static String VISIBLE-ROW-COUNT- 
PROPERTY 


protected int visibleRowCount 


El nombre de la propiedad li- 
gada para scrollsOnExpand. 


Devuelve true si un nodo se 
desplaza cuando es ex- 
pandido para mostrar todos 
sus descendientes. 


El nombre de la propiedad 
ligada para selectionModel. 


Modeliza el conjunto de nodos 
seleccionados en este árbol. 


Crea un nuevo evento y lo pa- 
sa a selectionListeners. 


El nombre de la propiedad li- 
gada para showsRootHand- 
les. 


Devuelve true si se muestran 
los sectores de primer nivel 
del árbol. 


El número de clics del ratón 
antes de expandir un nodo. 


El nombre la propiedad ligada 
para treeModel. 


El modelo que define el árbol 
visualizado para este objeto. 


Actualiza expandedstate. 


El nombre la propiedad ligada 
para visibleRowCount. 


El número de filas visibles ca- 
da vez. 


Tabla 18.8. Constructores de la clase JTree. 


Constructor y 


JTreaji 


Descripción 


Construye un JTree con un | 
modelo de ejemplo. 


Constructor 


JTree(Hashtable value) 


JTree(Object|] value) 


Jime Treebtodal newMadel!) 


JTree(TreeNode root) 


JTree(TreeNode root, boolean asks- 


AllowsChildren) 


JTree(Vector value) 


Descripción 


Construye un JTree creado a 
partir de una tabla hash. 


Construye un JTree con cada 
elemento de la matriz dada | 
como hijo de un nuevo nodo 
raíz. 


Construye una instancia de | 
JTree que visualiza un nodo | 
raíz utilizando el modelo de | 
datos proporcionado. 


| 
Construye un JTree con el 
TreeNode dado como raíz, 
que muestra el nodo raíz. 


Construye un JTree con el 
TreeNode dado como raíz, 
que visualiza el nodo raíz y 
decide si un nodo es un nodo 
hoja en la manera indicada. 


Construye un JTree con cada 
elemento del Vector dado 
como hijo de un nuevo nodo 
raíz que no se visualiza. 


Tabla 18.9. Métodos de la clase JTree. 


Método 

void addSelectionInterval(int index0, 

int indexl) 

void addSelectionPath(TreePathpath) 
void addSelectionPaths(TreePath[] paths) 


void addSelectionRow(int row) 


void addSelectionRows(int[] rows) 


Descripción 


Añade a la selección los cami- 
nos entre indexO y indexi, 
incluido. 


Añade el nodo identificado por 
el TreePathdado ala selección. 


Añade cada camino en la ma- 
triz de caminos a la selección. 


Añade el camino de la fila 
actual a la selección. 


Añade el camino de cada una 
de las filas dadas a la se- 
lección. 


Método 


void addTreeExpansionListener(TreeEx- 
pansionListener tel) 


void addTreeSelectionListener(TreeSelec- 
tionListener tsl) 


void addTreeWillExpandListener(TreeWill- 
ExpanoListener tel) 


void cancelEditing() 


void clearSelection() 


protected void clearToggledPaths() 


void collapsePath(TreePath path) 


void collapseRow(introw) 


String convertValueToText(Object value, 
boolean selected, boolean expanded, 
boolean leaf, int row, boolean hasFocus) 


protected static TreeModel createTree- 
Model(Object value) 


protected TreeModelListener createTree- 
ModelListener() 


void expandPath(TreePath path) 

void expandRow(int row) 

void fireTreeCollapsed(TreePathpath) 
void fireTreeExpanded(TreePathpaih) 


void fireTreeWillCollapse(TreePath path) 


Deseripelón 


Añade un receptor para even- 
tos TreeExpansion. 


Añade un receptor para even- 
tos TreeSelection. 


Añadeun receptor para even- 
tos TreeWillExpand. 


Cancela la sesión de edición 
actual. 


Limpia la selección. 


Limpia el caché de caminos 
alternativos. 


Asegura que el nodo identifi- 
cado por el camino actual está 
colapsado y es visible. 


Asegura que el nodo en la fila 
especificada está colapsado. 


Llamada por los renderizado- 
resparaconvertir el valordado 
al texto. 


Obtiene un TreeModel que 
encapsula el objeto dado. 


Crea y devuelve una instancia 
de TreeModelHandler. 


Asegura que el nodo identifi- 
cado por el camino dado se 
expande. 


Asegura que el nodo de la fila 
dada está expandido. 


Notificaatodos los receptores 
sobre este evento. 


Notificastodoslos receptores 
sobre este evento. 


Notificaatodoslos receptores 
sobre este evento. 


Método Descripción 


void fireTreeWillExpand(TreePath path) Notifica atodos los receptores 
sobre este evento. 


protected void fireValueChanged(TreeSe- Dispara un evento "valor cam- 
lectionEvent e) biado". 


AccessibleContext getAccessibleContext() Obtieneel AccessibleContext. 


TreeCellEditor getCellEditor() Obtiene el editor utilizado para 
editar entradas. 


TreeCellRenderer getCellRendererO Obtiene el TreeCellRenderer 
que renderiza cada celda. 


TreePath getClosestPathForLocation(intx, Obtiene el camino al nodo más 
int y) cercano a x, y. 


int getClosestRowPForLocation(int x, int y) Obtiene la fila del nodo más 
cercano a x, y. 


protected static TreeModel getDefault- Creay devuelve un TreeModel 

TreeModelO de ejemplo. 

protected Enumeration getDescendant- Obtiene una enumeración de 

ToggledPaths(TreePath parent) caminos TreePaths que ha 
sido expandida y desciende 
de parent. 

TreePath getEditingPathO Obtiene el camino del elemen- 
to que se edita en este mo- 
mento. 

Enumeration getExpandedDescendants Obtiene una enumeración de 

(TreePath parent) los descendientesde path que 


están expandidos ahora. 


boolean getinvokesStopCellEditing() Obtiene el indicador que infor- 
ma de lo que sucede cuando 
se interrumpe la edición. 


Object getLastSelectedPathComponent() Obtiene el último componente 
camino en el primer nodo de 
la selección actual. 


TreePath getLeadSelectionPaih() Obtiene el camino al último 
nodo añadido a la selección 
actual. 

int getLeadSelectionRow() Obtiene el índicede fila del últi- 


monodo añadidoalaselección. 


Método 


int getMaxSelectionRow() 
int getMinSelectionRow() 
TreeModel getModel() 


protected TreePath[] getPathBetween- 
Rows(int index0, int indexl) 


Rectangle getPathBounds(TreePaith path) 
TreePath getPathForLocation(int x, int y) 
TreePath getPathForRow(int row) 
Dimension getPreferredScrollableView- 
portSize() 

Rectangle getRowBounds(int row) 

int getRowCount() 

int getRowForLocation(int x, int y) 

int getRowForPath(TreePath path) 


int getRowHeight0 


int getScrollableBlockIncrement(Rectangle 
visibleRect, int orientation, int direction) 


boolean getScrollableTracksViewport- 
Height() 


boolean getScrollableTracksViewport- 
Width() 


Deseripeión 


Obtiene la Últimafilaseleccio- 
nada. 


Obtiene laprimerafilaseleccio- 
nada. 


Obtieneel TreeModelquepro- 
porciona los datos. 


Obtiene instancias JTreePath 
que representanel camino en- 
tre indexO e indexl, incluido. 


Obtiene el rectángulo en el 
que se dibuja el nodo dado. 


Obtiene el camino para el 
nodo en una posición dada. 


Obtiene el camino para la fila 
dada. 


Obtiene el tamaño visual pre- 
ferido de un JTree. 


Obtiene el rectángulo en que 
se dibuja el nodo en una fila 
dada. 


Obtiene el número total de 
filas. 


Obtiene la fila en la posición 
dada. 


Obtiene la fila que visualiza el 
nodo identificado por el ca- 
mino dado. 


Obtiene la altura de cada fila. 


Obtiene el incremento de blo- 
que. 


False indica que la altura del 
Viewport no determina la al- 
tura de la tabla. 


False indica que la anchura 
del Viewport no determina la 
anchura de la tabla. 
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Método Descripción y 


intgetScrollableUnitIincrement(Rectangle Obtiene la cantidad de incre- 
visibleRect, int orientation, int direction) mento en el desplazamiento. 


boolean getScrollsOnExpand() Devuelve true si el árbol se 
desplaza para mostrar los 
nodosescondidospreviamen- 
te. 


int getSelectionCount() Obtiene el número de nodos 
seleccionados. 


TreeSelectionModel getSelectionModel() Obtiene el modelo para las 
selecciones. 


TreePath getSelectionPath() Obtiene el camino del primer 
nodo seleccionado. 


TreePath[] getSelectionPaths() Obtiene el camino de todos 
los valores seleccionados. 


int[] getSelectionAows() Obtiene todas las filas se- 
leccionadas en curso. 


boolean getShowsRootHandles() Devuelve true si se muestran 
los iconos para los nodosraíz. 


String getToolTipText(MouseEvent event) Sobrescribe el método get- 
ToolTipText de JComponent 
para permitir que se muestren 
las ayudas de herramientas. 


TreeUl getUl() Obtiene el objeto apariencia 
que dibuja este componente. 


String getUlClassID() Obtiene el nombre de la clase 
apariencia que dibuja este 
componente. 


int getVisibleRowCount() Obtiene el número de filas 
que se visualiza en el área 
disponible. 


boolean hasBeenExpanded(TreePathpath) Devuelve true si el nodo iden- 
tificado por el camino se ha 
expandido alguna vez. 


boolean isCollapsed(int row) Devuelve true si el nodo en la 
posición dada de la fila está 
colapsado. 


Método 


boolean isCollapsed(TreePath path) 


boolean isEditableO 
boolean isEditing() 


boolean isExpanded(int row) 
boolean isExpanded(TreePath path) 
boolean isFixedRowHeight() 
boolean isLargeModel() 


boolean isPathEditable(TreePath path) 
boolean isPathSelected(TreePath path) 


boolean isRootVisible() 


boolean isRowsSelected(int row) 


boolean isSelectionEmpty() 


boolean isVisible(TreePath path) 


void makeVisible(TreePath path) 


Deseripelón 


Devuelve true si el valor iden- 
tificado por path está actual- 
mente colapsado. 


Devuelve true si el árbol puede 
ser editado. 


Devuelve true si el árbol está 
en modo de edición. 


Devuelve true si el nodo en 
una fila dada de pantalla está 
actualmente expandido. 


Devuelve true si el nodo 
identificadopor elcaminoestá 
actualmente expandido. 


Devuelve true si la altura de 
cada fila en pantalla tiene 
tamaño fijo. 


Devuelve true si el árbol está 
configurado para modelo lar- 


go. 
Obtiene el valor de isEditable. 


Devuelve true si el elemento 
identificadopor el caminoestá 
seleccionado actualmente. 


Devuelve true si el nodo raíz 
del árbol es visible. 


Devuelve true si el nodo iden- 
tificado por row está seleccio- 
nado. 


Devuelve true si la selección 
está actualmente vacía. 


Devuelvetrue sielvaloridenti- 
ficado por path es visible ac- 
tualmente. 


Asegura que el nodo identi- 
ficado por path es actual- 
mente visible. 
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Método 


protected String paramString() 


protected void removeDescendantTogg- 
ledPaths(EnumerationtoRemove) 


void removeSelectionInterval(int index0, 
int index!) 


void removeSelectionPath(TreePath path) 


void rernoveSelectionPaths(TreePath[] 
paths) 


void removeSelectionRow(int row) 


void removeSelectionRows(int[] rows) 


void removeTreeExpansionListener(Tree- 
ExpansionListener tel) 


void removeTreeSelectionListener(Tree- 
SelectionListenertsl) 


void removeTreeWillExpandListener(Tree- 
WillExpandListenertel) 


void scrollPathToVisible(TreePath path) 


void scrollRowToVisible(int row) 


void setCellEditor(TreeCellEditor cellEditor) 


void setCellRenderer(TreeCellRenderer x) 


void setEditable(boolean flag) 


Descripción 


Obtiene una representación 
de cadena de este JTree. 


Eliminacualquierdescendien- 
te de toRemove en TreePaths 
que siga expandido. 


Elimina de la selección los 
nodos entre indexO e index, 
incluido. 


Elimina el nodo identificado 
por el camino dado de la se- 
lección. 


Elimina el nodo identificado 
por los caminos dados de la 
selección actual. 


Elimina el camino en el índice 
de fila de la selección actual. 


Elimina los caminos seleccio- 
nadosen cada unadelas filas 
dadas. 


Elimina un receptor de even- 
tos TreeExpansion. 


Elimina un receptor TreeSe- 
lection. 


Elimina al receptor de eventos 
TreeWillExpana. 


Se desplaza para que el nodo 
identificado por path sea visi- 
ble. 


Desplaza el elemento identifi- 
cado por row hasta que sea 
visible. 


Asigna el editor de celdas. 


Asigna el TreeCellRenderer 
que se utilizará para dibujar 
cada celda. 


Determinasiel árboleseditable. 


Descripción 


Método 


protected void setExpandedState 
(TreePath path, boolean state) 


void setinvokesStopCellEditing(boolean 
| newvalue) 


void setLargeModel(boolean newvalue) 


void setModel(TreeMode1newModel) 
| voidsetRootVisible(boolean rootvisible) 
void setRowHeight(int rowHeight) 


void setScrollsOnExpand(boolean newvalue) 


void setSelectionInterval(int indexo0, int 
index!) 


void setSelectionModel(TreeSelectionModel 
selectionModel) 
void setSelectionPath(TreePath path) 


void setSelectionPaths(TreePath[] paths) 


void setSelectionRow(int row) 


void setSelectionRows(int[] rows) 


void setShowsRootHandles(boolean new- 
Value) 


void setUl(TreeUl ui) 


Asigna el estado expandido 
del receptor. 


Determina lo que sucede 
cuando se interrumpe la edi- 
ción. 

Especifica si la interfaz de 
usuariodeberíautilizarun mo- 
delo largo. 


Asigna el TreeModel que pro- 
porciona los datos. 


Determina si el nodo raíz de 
TreeModel es visible. 


Asignala altura de cada celda. 


Determinasialgo deberíades- 
plazarse cuando se expande 
un nodo. 


Selecciona los nodos entre 
indexO e index, incluido. 


Asignael modelo de selección 
del árbol. 


Selecciona el nodo identifi- 
cado por un camino dado. 


Selecciona los nodos identifi- 
cados por una matriz de cami- 
nos. 


Selecciona el nodo en la fila 
dada en pantalla. 


Selecciona los nodos corres- 
pondientes a cada una de las 
filas dadas en pantalla. 


Determina si los iconos de 
nodo se visualizan. 


Asigna el objeto apariencia 
que renderiza este compo- 
nente. 


Método Descripción 


void setVisibleRowCount(int newcount) Asigna el número de filas visi- 
bles. 

void startEditingAtPath(TreePath path) Selecciona el camino dado e 
inicia la edición. 

boolean stopEditing() Finaliza la sesión de edición. 

void treeDidChange0 Se llama cuando el árbol ha 


cambiado lo suficiente y nece- 
sita cambiar sus límites de 
tamaño. 


void updateUl() Llamadopor UlManagercuan- 
do la apariencia cambia. 


Puede añadir datos ahora a un árbol de diversas formas; en este capítulo, 
utilizaremos una técnica conocida: la creación de una tabla hash, rellenar los 
datos y añadir esa hash al árbol. Puede utilizar JTree para mostrar nodos 
compuestos (por ejemplo, nodos que contienen tanto un icono gráfico como 
texto), subclasificando TreeCellRenderer y utilizando setTreeCellRenderer. 
Para editar nodos, puede subclasificar TreeCellEditor y utilizar setTree- 
CellEditor. 

Aquí tiene un ejemplo rápido. En este caso, basta crear un árbol predeter- 
minado y añadirlo a un panel de desplazamiento: 


import jJava.awt.*; 
import javax.swing.*; 
import javax.swing.tree.*; 


/* 
<APPLET 
CODE = tree.class 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
27 


public class tree extends JApplet 
i 

public void hito 

( 


JTree jtree = new JTreeO0; 


gatContanEPne |] adds JIcrolliPabeidtras lia 


Este código es todo lo que necesita para mostrar un árbol básico; la figura 
18.1 muestra este código, donde puede ver que la Swing ha añadido algunos 
datos predeterminados al árbol. Este ejemplo se encuentra en el archivo 
tree-javadel CD. 


[Ejúpraial dera rez clara 
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PY méd 
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[y bananas 


Figura 18.1. Un árbol básico. 


m Swing: 
Componentes 
de texto 


Crear componentes de texto en Swing: la clase 
JTextComponent 


Los componentes de texto de la Swing se crean sobre la clase JTextCompo- 
nent y merece la pena examinar los campos, constructores y métodos de esta 
clase debido a que todos los componentes de la Swing heredan de él. Aquí 
tiene el diagrama de herencia para la clase JTextComponent: 


Crear campos de texto 


El campo de texto es el control de texto básico de la Swing. De hecho, ya 
hemos utilizado campos de texto previamente en el capítulo 12. Aquí tiene el 
diagrama de herencia de la clase JTextField: 


g5 


En el capítulo 12, encontrará los constructores de la clase JTextField 
mostrados en la tabla 12.6 y sus métodos en la tabla 12.7. Aquí tiene un breve 


ejemplo que hace funcionar un campo de texto: 
import java.awt.*; 
import javax.swing.*; 
import Java.awt.event.*; 


CODE = textfield.class 

WIDTH = 350 

HEIGHT = 280 > 
I/APPLET> 


public class textfield extends JApplet 
{ 
JTextField text = new JTextField(20); 


public void inito0 
I 


Container contentpane = getContentPane0; 


contentPane.setLayout (new FlowLayoutol 
contentPane.add (text); 


text .setText ( minola desde Swinglm ); 


1 


Examinaremos alguna de las capacidades de los campos de texto de la 
Swing en los dos temas siguientes. 


Ajustar la alineación del campo de texto 


7 


"Mmh", dice el programador novato, "me ha llegado un memorándum 
extraño del gran jefe. Dice: "Estamos probando algo nuevo. Alinear a la 


izquierda todo el texto". ¿Es algo político?". Sonreímos y decimos, "No, se 
trata de los campos de texto". 

Puede asignar la alineación de los campos de texto con el método 
setHorizontalAlignment (no existe método setVerticalAlignment). Aquí tie- 
ne un ejemplo que muestra las posibilidades: derecha, izquierda y centrada. 
En este caso, permitimos al usuario hacer clic sobre un botón para asignar la 
alineación del texto en un campo de texto; después, utilizamos el método 
setHorizontalAlignment para justificar el texto y que coincida. Aquí tiene el 


código: 


. ` * 

import java.awt. ; 
import javax.swing.*; 
import java.awt.event.*;}; 


ya 
<APPLET 
CODE = textfieldalign.class 
WIDTH = 350 
HEIGHT = 280 > 
</APPLET> 
y 


public class textfieldalign extends JApplet 


I 
JTextField jtextfield = new JTextField("¡Hola desde Swing!"); 


JButton jbuttonl, jbutton2, jbutton3; 


public void init() 
{ 


Container contentpane = getContentPane0; 


class buttonpanel extends JPanel implements ActionListener 
{ 


public buttonpanel() 
{ 


jbuttonl new JButton("lzquierda"); 
jbutton2 = new JButton ("DerechaW); 
jbutton3 new JButton ("Centrado"); 


add (new -“abel("-ustificación")); 
addíjbuttonl); 
add (jbutton2); 
add (jbutton3l : 


public void actionPerformed (ActionEvent e) 
{ 
if(e.getSource() == jbuttonl) { 
jtextfield.setHorizontalAlignment (JTextField. LEFT); 
1 else if(e.getSource0 == jbuttoni) { 
jtextfield.setHorizontalAlignment (JTextField.RIGHT); 
ds else ifia.petscurce[] =a jbuttonyi ( 
taxtiiald, astiorisostalaligenent |JTaxtFiesld. CENTER) 
F 


La figura 19.1 muestra el resultado de este código, donde el usuario puede 
asignar la alineación del texto en el campo de texto con sólo hacer clic sobre 
un botón. Este ejemplo se encuentra en el archivo textfieldalign-java del CD 
que acompaña a este libro. 


setColumns en el campo de texto de este ejemplo vara ave pueda v 
espacio horizor tal que role in texto actual. Existen dos cosi 
observar aquí: la primera, que el tamaño de una c:olurnna de un cal 
de texto o3“ia anchura de la letra m, por tanto selColumns no as 
reafmenite el ncíinero visible de caracteres. Segundo, setColumas a 
na únicimente e:l tarnañó preferente del campa d texto. | 


A rinin 


Figura 19.1. Alineación del texto de un campo de texto. 


Desplazar campos de texto 


"Tengo un problema”, dice el programador novato. "Estoy escribiendo mi 
novela en un campo de texto y realmente odio tener que desplazarme por todo 
el texto utilizando el teclado". "Bien", decimos. "Puede desplazar el campo 
de texto, pero debería utilizar en su lugar un área de texto cuando trabaje con 
gran cantidad de texto". El PN dice: "jcuénteme más!" 

Los campos de texto de la Swing implementan la interfaz Scrollable, lo 
que implica que podemos desplazar el texto bajo control de programa o 
dentro de paneles de desplazamiento. Aquí tiene un ejemplo que muestra 
cómo funciona. En este caso, utilizamos el método getHorizontalVisibility 
del campo de texto para obtener un objeto que implemente la interfaz 
BoundedRangeModel y pasamos este objeto al constructor de un deslizador, 
implementando directamente el desplazamiento, sin un panel de desplaza- 
miento. Cuando el usuario ajuste el deslizador, utilizamos el método 
setScrollOffset del campo de texto para desplazar el texto contenido en el 
campo. Primero, no obstante, examine los métodos de la interfaz 
BoundedRangeModel, que están especialmente diseñados para facilitar los 
controles de desplazamiento. 

Aquí tiene el código real. En este caso, situamos una cadena larga en un 
campo de texto corto y conectamos el campo de texto a un deslizador, como 
se esquematiza al comienzo de este tema: 


import java.awt.*; 
import javax.swing.*; 
import javax.swing.event.*; 


JF 
<APPLET 
CODE = textfieldscroll.class 
WIDTH = 350 
HEIGHT = 280> 
</APPLET> 
*7 


public class textfieldscroll extends JApplet 
I 
private JTextField jtextfield = new JTextField( 
"Aquí tenemos un bonito texto largo para un campo de texto.", 12); 


public void inito0 


t 
Container contentpane = getContentPane0; 


489 


class Jsliderpanel extends JPanel 


( 
JSlider jslider = new 
JSlider (jtextfield.getHorizontalVisibilityo ); 


public jsliderpanelo { 
addínew JLabel ("Desplazar el texto:")); 


add (jslider) ; 


jslider.addChangeListener (new ChangeListenero ( 
public void stateChanged (ChangeEvent e) ( 
Jtatiiald. asbscrollolfistiislider getYalus ida 


} 


La figura 19.2 muestra el resultado. Como podemos ver, este applet con- 
tiene un campo de texto y un deslizador y podemos desplazar el texto del 
campo utilizando el deslizador. Eso es todo; este applet es un éxito. Encon- 
trará el archivo textfieldscroll.java en el CD. 


Figura 19.2. Desplazamiento de un campo de texto. 


Crear campos de palabra clave 


"¡Ayuda!" Llora una voz sobre el teléfono y decidimos que debe ser el 
programador novato. '¿Quéva mal, PN?", preguntamos. "¡El dichoso Felipe 
se pone detrás de mí y lee mi palabra clave mientras escribo!”, dice el PN. 


"Bien", decimos, "cambie sus palabras claves por otras nuevas; y pase a 
campos de palabra clave en lugar de campos de texto". "Gracias", dice el PN, 
aliviado. 

La Swing incluye un control especial para la introducción de palabras 
clave; el control JPasswordField. Puede asignar el carácter que se muestra 
con cada tecla en este control cada vez que el usuario escribe un carácter, para 
que la palabra clave escrita no sea visible realmente. Además, la copia al 
portapapeles está inhabilitada para este control. De esta forma, nadie puede 
copiar y pegar su palabra clave. Aquí tiene el diagrama de herencia para 
JPasswordField: 


java. lang.0bject 


Utilizamos el método setEchoChar para asignar el carácter de eco en un 
campo de palabra clave y podemos utilizar el método getpassword para leer 
la palabra clave escrita. El método getpassword devuelve una matriz de 
caracteres, pero podemos transformarla a un objeto String pasándola al cons- 
tructor de String. 

Aquí tiene un ejemplo en el que la palabra clave actual es "4brete sésamo" 
y, si el usuario escribe esta palabra clave y pulsa Intro, el applet visualizará 
"Correcta" en su barra de estado; en cualquier otro caso, visualizará "Inco- 
rrecta". Aquí tiene el código (observe que para capturar eventos de pulsación 
de Intro, hemos añadido un receptor de acción al control de palabra clave): 


import java.awt.*; 
import javax.swing.*; 
import java.awt.event.*; 


CODE = password.class 

WIDTH = 350 

HEIGHT = 280 > 
</APPLET> 

“7 


public class password extends JApplet 


String correctpassword = "ábrete sésamo"; 
JpasswordField jgasswordfield = new JPasswordField(10); 


public void hit () 
{ 


Container contentpane = getContentPane0; 


contentPane.setLayout (new FlowLayouto ); 
contentPane.add (new JLabel ("1Introduzcasu palabra clave: ")) 
contentPane.add (jpasswordfield); 


ipañiordfield, pnetEchoCkar(**']¿ 


jpassworcIfield.addActionListener (newActionListeneroO ( 
public void action-erformed(ActionEvent e) ( 
String input = new String(jpasswordfielcY.getPassword()); 


ificorssctpassword.squala input!) 
ebowBtatua]|*Correcta”); 
alma 


ahowitalus ¡"Incorrecta 


La figura 19,3 muestra el resultado de este código. Como vemos, el campo 
de palabra clave visualiza el carácter de eco y comprueba la palabra clave 
cuando el usuario pulsa Intro. Este ejemplo se encuentra en el archivo 
password.java del CD. 


Figura 19.3. Uso de un campo de palabra clave. 


m Stream 70 
y archivos 


Usar la clase File 


"Mmh", dice el programador novato, "es un poco molesto; mi programa 
intentaba abrir un archivo que no existía, justo cuando lo ejecutaba para el 
gran jefe". "Bien", decimos, "¿porqué no probar primero si existía el archivo 
utilizando el método exists de la clase File?". El PN dice, "¡Explíquemelo!" 

Puede utilizar la clase File para determinar muchas cosas sobre archivos, 
como su tamaño, si se puede escribir sobre ellos, si un elemento es un 
archivo, directorio o conexión de nombres, y más aún. Aquí tiene el diagrama 
de herencia para la clase File: 


java.lang .Object 


+-javaio.File 


Observe que puede utilizar isFile para determinar si un elemento es un 
archivo verdadero u otra cosa, como un directorio (lo puede comprobar con 
isDirectory) o una conexión de nombres. Utilice toURL para convertir la vía 
de acceso de un archivo a un URL, renombrar archivos y otros con la clase 
File. 


Examinaremos un ejemplo: haremos funcionar varios métodos de la clase 
File, obteniendo alguna información sobre un archivo llamado file.txt. Aquí 
tiene la apariencia del código: 


import java.io.File; 


class file 
I 


public static void main (Stringargs[!) 


( 
File filel = new File(nfile.txt"); 


System.out.println(nArchivo: " + filel.getName0 + (filel.isFile()? 
" es un archivo” : " es un filtro”)); 
System.out.println("Tamaií0: " + filel-lengtho); 
System.o-t.println(“-Víade acceso: ARE filel.getPath0); 
System.o-t.println(“-Víade acceso absoluta: "4 
filel.getAbaolutePath ()); 
System. ~ut .println(-Ultimamodificación del archivo: 
filel.lastModified()); 
System.out.println(filel.existso 7 "El archivo existen : "El 
archivo no existe”); 
System.out.println(filel.canRead() ? "Sepuede leer el archivo": 
"No se puede leer el archivo"); 
System.out.grintln(filel.canWriteO0 ? "Se puede escribir al 
archivo" 1 


.No se puede leer el archivo"); 
System.out.println(filel.isDirectory”) ? "El archivo es un 
directorio" :£ 
"El archivo no es un directoriom); 


Aquí tiene los resultados de este código (observe que la hora en que se 
modificó por última vez el archivo se recibe de la forma habitual; ms desde el 
1/1/70, que puede convertir a una fecha más legible con la clase Date): 


java file 

Archivo: file.txt es un archivo 

Tamaño: 23 

Vía de acceso: file.txt 

Vía de acceso absoluta: C:Mfile.txt 

Ultima modificación del archivo: 953020822000 
El archivo existe 

Se puede leer el archivo 

Se puede escribir al archivo 

El archivo no es un directorio 


Esto es todo. Este ejemplo se encuentra en el archivo file-java del CD que 
acompaña a este libro. Como puede ver, el uso de la clase File puede determi- 
nar un gran impacto sobre archivos y directorios. 


Trabajar con InputStream 


El programador novato aparece y dice, "Estoy listo para comenzar a traba- 
jar con archivos. ¿Dónde comienzo?" "Comience”, decimos, "con las clases 
InputStream y OutputStream". 

Las clases InputStream y OutputStream son las clases base de la entrada y 
salida orientadas a bytes en Java, por lo que merece la pena examinar los 
métodos que proporcionan estas clases a todas las demás clases orientadas a 
stream de bytes. Aquí tiene el diagrama de herencia para la clase InputStream, 
en la que se basan los streams de entrada: 


Examinaremos la clase OutputStream en el tema siguiente. 


Trabajar con OutputStream 


El opuesto de la clase InputStream, introducida en el tema previo, es la 
clase OutputStream, en la que se basan los streams de salida. Aquí tiene el 
diagrama de herencia de OutputStream: 


Ahora que hemos visto InputStream y OutputStream, es el momento de 
hacer funcionar estas clases, comenzando en el tema siguiente. 


Trabajar con Filelnputstream 


"Necesito abrir un archivo de imagen y trabajar con sus bytes individua- 
les", dice el programador novato. "¿Cómo puedo hacerlo?" "Puede utilizar la 
clase FileInputStream para trabajar con los bytes de un archivo", decimos. El 
PN dice "¡Explíquemelo!" 

La clase FilelnputStream está diseñada especialmente para trabajar con 
archivos de entrada orientados a bytes y deriva de la clase InputStream, como 
se muestra aquí: 


Bon 


TAVA 3 AputEtrean 


+-java.io.FilelnputStream 


Y 
Para crear un stream de entrada de archivo, utilizamos el constructor de la 


clase FileInputStream. Aquí tiene los métodos de lectura que debe utilizar 
con esta clase: 


e int read(). Lee un byte de datos desde su stream de entrada y lo 
devuelve. 


e int read(byte[] b). Lee hasta b.length bytes de datos del stream de 
entrada en una matriz de bytes y devuelve el número leído de bytes. 


e intread(byte[]b, int off, int len). Lee hasta len bytes de datos de este 
stream de entrada en una matriz de bytes y devuelve el número leído de 
bytes. 


Vamos a examinar un ejemplo. En este caso, abriremos el propio código 
fuente de la aplicación, leeremos y mostraremos 50 bytes de código, saltare- 
mos 50 bytes con el método skip y después leeremos y mostraremos 50 bytes 
más (observe que también podemos determinar cuántos bytes existen a la 
espera de lectura utilizando el método available, y que podemos cerrar el 
stream al final del código): 


Pi . 2 * 
import java.io. ; 


class fileinputstream 
t 
public static void main (String args[1) throws Exception 
{ 
int size; 
PileInputStream fileinputstream = new 
FileInp~tStream(~fileinputstream. java"); 
Systa.o-t.println(-Bytesdisponibles: "+ (size= 
fileinputstream.available0)); 
System.out .println(mvweyencio50 by te”*....*); 


byte bytearray [l = new byteCc501; 
if (fileinputstream.read(bytearray) 1= 50) C 

System. -ut .println(-Nose pudieron leer 50 bytesn); 
1 
Ayetea.cut. printininew Sring[(bytesrray, 0, 501]|5 
Aystea. cut. privtlol"Iigpnorilado 50 Ebyras..."i; 


filelinpaterreas. ap (50) 


yaten., ott., printini{" Leyendo 50 by... Ep 


if (fileinputitrram.read(bytearray) 1= 50) ( 
Syetem.out.println('No se pudieron leer 50 byteen); 

> 

syst-.out.println (new String(bytearray, 0, 50)); 


fillsiapuecstroaa. close lio 


Aquí tiene la salida de este código: 


java fileinputstream 
Bytes disponibles: 982 
Leyendo 50 bytesS.... 
import Java.io.*; 


class fileinputstream 
( 


Ignorando 50 bytes... 
Leyendo 50 bytes.... 
ception 


{ 
int size; 
Fileln 


Eso es todo. Este ejemplo se encuentra en el archivo fileinputstream.java 
del CD. 


Trabajar con FileOutputStream 


"Bien", dice el programador novato, "sé que se utiliza FilelnputStream 
para leer desde archivos, pero, ¿qué clase puedo utilizar si quiero escribir en 
un archivo?" Sonreímos y decimos, "Apuesto a que lo puede adivinar" 

Puede utilizar la clase FileOutputStream para escribir datos, byte a byte, a 
un archivo. Aquí tiene el diagrama de herencia para esa clase, que deriva de la 
clase OutputStream: 


«—java.do.FiledutputEbream 


Aquí tiene los métodos de escritura que puede utilizar con esta clase: 


e int write(byte[]b). Escribe b.length bytes a partir de la matriz de bytes 
dada a este stream de archivo de salida. 


e void write(byte[]b, int off, int len). Escribe len bytes a partir de la 
matriz de bytes de entrada, iniciando el desplazamiento en off a este 
stream de salida de archivo. 


e voiú write(int b). Escribe el byte dado a este stream de salida de 
archivo. 


Aquí tiene un ejemplo en el que escribimos la cadena de texto "Esto es una 
cadena de texto." a un archivo de tres formas: byte a byte, todos a la vez y en 
parte. Aquí tiene la apariencia el código: 


import Java.io.*; 


class fileoutputstream 


( 


public static void main (String args[1i throws Exception 


( 
byte data[] = -Esto es una cadena de texto. ' .getBytes () ; 


“ileO0utputStreamfileoutputstreaml = new 
FileO0utputStream("filel.txt"); 
for (int loop—index = O; loop-indax < data-lemgth; loop-indax++) ( 
filecutputatresal .writeídata (lo00p_ index) 
ll 


File0utputStream fileoutputstread = new 
File0utputStream("file2.txt"); 
fileoutputstread.write (data); 


File0utputStream fileoutputstread = new 
File0utputStrram("file3.txt"); 
fileoutputstread.write(data, 5, 10); 


filesutpatatreaml.clona li; 
filecotpoterreani.clons [ip 
Filssutputsireiad.clomó li; 


Eso es todo. Este ejemplo se encuentra en el archivo fileoutputstream.java 
del CD. 


Trabajar con ByteArrayInputStream 


"Tengo una matriz de bytes enorme en mi programa", dice el programador 
novato, "y siempre pierdo la posición en ella. ¡No está bien que no podamos 
tratar una matriz de bytes como un archivo y abrir un stream de entrada para 
ella!" "Síse puede", decimos. El PN se queda asombrado. 


Puede utilizar la clase ByteArrayInputStream para abrir un stream de 
entrada desde una matriz de bytes en memoria. Aquí tiene el diagrama de 
herencia para esta clase: 


jara Llano. Object 
siama, 10, Input trezn 
iaa, io, MWytalreayInpotstras4n 


Aquí tiene un ejemplo. En este caso, únicamente creamos un bufSer de 
memoria con el texto "Aquí tenemos una cadena" y después abrimos un 
ByteArrayInputStream con ese buffer, leemos y visualizamos el texto byte a 
byte: 


import java.io.*; 


class bytearrayinputstream 


{ 


public static void main (String args[1) throws IOException 


{ 
byte data[] = .Aquí tenemos una cadenan.getBytesO; 


ByteArrayInputStream in = new ByteArrayInputStream (data) i 
int charactert 
while ( (character = in.read0) I= -1)( 
Systera.out.printi (char) character); 
1 
1 
Aquí tiene la salida de este código: 


ciX>Javabytearrayniputstream 
Aquí tenemos una cadena 


Eso es todo. Este ejemplo se encuentra en el archivo bytearrayinputstream. 
java del CD. 


Trabajar con ByteArrayOutputStream 


"Por tanto, podemos leer bytes con ByteArrayInputStreamUdice el pro- 
gramador novato. "¿Podemos escribirlos también?" "Claro", decimos, "con 
ByteArrayOutputStream". 

La clase ByteArrayOutputStream permite escribir stream de bytes a bu- 
ffer. Aquí tiene el diagrama de herencia para esta clase: 


java: do. Dubputstesam 
ara lo, BpeeArray0utputStrama 


Aquí tiene un ejemplo. En este caso, estamos escribiendo bytes a 
ByteArrayOutputStream, escribiendo bytes a un buffer de memoria y envian- 
do los bytes a un stream de salida de archivo: 


P . P * 
import java.io. ;5; 


class bytearrayoutputstream 


( 


public static void main (String args[]) throws IOException 


{ 
ByteArrayOutputStream bytearrayoutputatresm = new 


ByteArrayOutputStreamo; 
byte data[] = "Aquí tenemos una cadenan.getBytesO; 


byrtearraryousputsetream. rita data) ; 
Eystem. out.print in |bytaarrayoutputatraam:tostriegi])i 


byte buffer[] = bytearrayoutputstreaul .toByteArray0; 
for (int loop_iPdax = 0; loop—index < data-length; loop-index++) { 
System.out.print ( (char) buffer [loop-indexl1) ; 
1 


OUtputStream fileoutputetream = new FileOUtputStream("file.txt"); 
bytearrayoutputetream.writeTo (fileoutputetream) ; 
Eilësuitputatraam. clona |) y 


Este ejemplo se encuentra en el archivo bytearrayoutputstream.java del 
CD. Aquí tiene la salida de este código: 
java bytearrayoutputstream 


Aquí tenemos una cadena 
Aquí tenemos una cadena 


m Programación 
multihilo 
y animación 


En este capítulo, vamos a examinar la programación multihilo de Java y 
cómo permite la animación de gráficos. Un hilo es un flujo de ejecución de 
código y, mediante el uso de hilos, podemos hacer que nuestros programas 
aparentemente realicen varias tareas al mismo tiempo. Por ejemplo, su códi- 
go podría interaccionar con el usuario mientras realiza tareas en segundo 
plano de gran consumo de tiempo. Los hilos separados realmente no se 
ejecutan al mismo tiempo, por supuesto (a menos que tenga una máquina 
multiprocesadora); en realidad, cada hilo obtiene secuencias de tiempo del 
mismo procesador. El resultado aparente, no obstante, es que los diversos 
hilos se ejecutan al mismo tiempo y puede resultar impresionante. De hecho, 
Java es uno de los pocos lenguajes de programación que soporta multihilos 
explícitamente. 


Truco: Muchos componentes en Java, sobre todo la mayoría de los 
compionentes de la $wling, no zon de hilo seguro; es decir. no es seguro 
titilizarlos de umi forma multi hilo. 


Usar hilos en Java 


Cuando se inicia un programa Java, éste tiene un hilo: el hilo principal. 
Podemos interaccionar con el hilo principal de diversas formas, como vere- 


mos en este capítulo, por ejemplo obteniendo o asignando su nombre, dete- 
niéndolo y mucho más. Sin embargo, podemos también iniciar otros hilos. 
Podemos iniciar el código en esos hilos llamando al método start del objeto y 
situando el código que queremos que utilice el hilo en el método run. 

Existen dos formas para crear nuevos hilos. Una es declarar una clase que 
extienda Thread. Esta subclase sobrescribiría el método run de la clase Thread 
y a continuación podemos alojar e iniciar una instancia de esa clase. Por 
ejemplo, aquí tiene la forma de definir una nueva clase Thread que se inicia 
cuando crea una instancia: 


class CustomIhread extends Thread 


( 
CustomThread() 


c 
// Constructor de inicio estándar 
starto; 


public void runo 
I 


// Realice el trabajo para el que se creó este hilo 


1 


También puede crear e iniciar un hilo de este tipo como sigue: 


CustomThread threadl = new CustomThreado; 


La otra forma de crear un hilo es declarar una clase que implemente la 
interfaz Runnable. Esa clase entonces implementará el método run. Una 
instancia de la clase puede alojarse (es decir, pasarse como argumento cuan- 
do crea un objeto Thread). Aquí tiene su apariencia en el código: 


class CustomThread extends Thread 


1 
Thread thread; 


CustomThread() 

c 
// Constructor de inicio estándar 
thread = new CustomThread( this, "segundo"); 
thread.start0; 


public void run () 


( 


// Realice el trabajo para el que se creó este hilo 


1 
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Este código entonces crearía un hilo de este tipo e iniciaría su ejecución: 
CustomThread threadl = new CustomThreadoO; 


También es interesante observar que cada hilo tiene un nombre para pro- 
pósitos de identificación (de hecho, más de un hilo puede tener el mismo 
nombre). Cualquier hilo también tiene una prioridad y los hilos con priorida- 
des mayores se ejecutan de forma preferente con respecto a los hilos de 
prioridad menor. 

Esto es todo para el resumen de lo que aparece en este capítulo. Vamos a 
hacer funcionar la programación multihilo. 


Obtener el hilo principal 


El programador novato aparece y dice, "¿Hilos? He estado programando 
Java durante un tiempo y no he visto ningún hilo". Sonreímos y contestamos, 
"Todo programa Java al menos tiene un hilo, llamado hilo principal y que 
podemos observar con el método currentThreadW. 

El método currentThread de la clase Thread obtiene el hilo actual; si está 
ejecutando el hilo principal, currentThread devuelve el hilo principal. Aquí 
tiene un ejemplo en el que se obtiene el hilo principal de una aplicación y se 
imprime su nombre utilizando el método getName (observe que puede asig- 
nar el nombre de un hilo con setName; consulte el siguiente tema): 


class mainthread 
I 
public static void mainístring args[1) 
I 
Thread thread = Thread.currentThreadO ; 
System.out.println("Elhiloprincipal se llama ' 


1 


+thread.getNameo0); 
) 


Aquí tiene la salida de este código (mainthread.java en el CD que acompa- 
ña a este libro): 


c:X>java mainthread 
El hilo principal se llama main 


Dar nombre a un hilo 


Una forma de distinguir los hilos es por su nombre y podemos asignar el 
nombre de un hilo con el método setName. Aquí tiene un ejemplo en el que 
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cambiamos el nombre del hilo principal en una aplicación y visualizamos ese 
nombre: 


class setname 
{ 
public static void mainistring args[1) 
I 
Thread thread = Thread.currentThreadO; 


System.out .println(*El nombre original del hilo principal es " + 
thread.getName0); 


thread.setName ("Elhilo principal"); 


"+ 


System.out.println("El nombre del hilo principal es ahora 
thread.getName (1); 


Aquí tiene el código de salida (setname-javaen el CD): 


c:X>Jjava setname 
El nombre original del hilo principal es main 
El nombre del hilo principal es ahora El hilo principal 


Una vez ha dado un nombre a un hilo, puede utilizar el método getName 
para comprobar el nombre y así determinar cuál es el hilo que está trabajando 
con una sección de código que ejecutan muchos hilos (como el código del 
método run de la clase Thread). 


Detener un hilo 


Algunas veces, deseará detener la ejecución de un hilo y puede hacerlo 
con el método sleep. Puede pasar a este método la cantidad de tiempo de 
espera, en milisegundos (un milisegundo es una milésima de segundo) y el 
hilo quedará detenido esa cantidad de tiempo antes de continuar. Aquí tiene 
un ejemplo en el que imprimimos un mensaje, y detenemos el hilo durante un 
segundo entre las palabras: 


class sleep 
{ 
public static void main (String args[1) 
{ 
try t 
System.out.println("Holaa!) 
Thread.sleep (1000); 
System.out .println ("desde" y 


Thread.sleep (1000) ; 
System.out.println("Java."); 
~hread.sleep (1000); 

) catch (InterruptedExceptione) (} 


1 


Aquí tiene el resultado. Cuando ejecute este código (sleep-javaen el CD), 
verá las palabras apareciendo con un intervalo de un segundo entre ellas: 


c:\> java sleep 
Hola 
desde 
Java. 


Crear un hilo con la interfaz Runnable 


"Quiero crear un nuevo hilo para realizar el análisis sintáctico de un 
documento mientras el usuario está haciendo otras cosas", dice el programa- 
dor novato. "¿Cómo lo hago?" "Bien", decimos, "existen dos formas de crear 
sus propios hilos; implementar la interfaz Runnable y extender la clase Thread". 
"Mmh", dice el PN, "vamos a comenzar con Runnable". 

La sobrescritura de la interfaz Runnable es una de las dos formas de crear 
sus propios hilos en Java. Esta interfaz únicamente tiene un método: run. 
Basta situar el código que queremos que ejecute el nuevo hilo en el método 
anterior. Cuando creemos un nuevo objeto Runnable, podemos pasar ese 
objeto al constructor de la clase Thread para crear el nuevo hilo. 

Aquí tiene un ejemplo en el cual creamos una nueva clase que implementa 
la interfaz Runnable. Se pasa a sí misma al constructor de la clase Thread y se 
inicia cuando se crea un objeto de esta clase. Cuando se ejecuta, imprime su 
nombre una vez por segundo durante diez segundos y después sale. Aquí 
tiene el código para la clase Runnable, que llamaremos SecondThread (obser- 
ve que el trabajo actual se realiza en el método run y que el código se ejecuta 
con el método start de la clase Thread): 


class SecondThread implements Runnable 


{ 
Thread thread; 


SecondThread (>) 

i 
thread = new Thread(thi8, "segundo"); 
System.out.println("-niciando segundo hilo"); 
thread-startO0; 


public void runo 
E 
try ( 
foriint loop-index = 0; loop-index < 10; loop-index++) ( 
System.out.println( (Thread.currentThreadO) .getNae0 
+ m hilo aquí..."); 
Thread. sleep (1000); 
1 
1 catch (InterruptedExceptione) (1 


Systern.o-t.println(-Finaldel segundo hilo."); 
1 


Aquí tiene la aplicación que creará un nuevo hilo de la clase SecondThread 
y lo ejecutará; observe también que hacemos que el proceso principal impri- 
ma su nombre para que pueda ver la alternancia entre los dos hilos: 


class runnable 
{ 
public static void main (String args[]) 


( 


SecondThread secondthread = new SecondThreado; 


try ( 
for (int loop—index = 0; loop—index < 10; loop-index++) ( 
System.out .printl1ní (Thread. current ThreadO) .getName () 
+ " hilo aquí...")5 
Thread.sleep(1000); 
1 


) catch (InterruptedExceptione) {) 


4 


Aquí tiene el resultado de este código (runnable-javaen el CD). Observe 
que los dos hilos alternan la impresión de sus nombres (además, observe que 
no puede garantizar que quedarán alternados; eso depende del sistema opera- 
tivo): 


c:\>java runnable 
Iniciando segundo hilo 
main hilo aquí.. 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí.. 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 


segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
Final del segundo hilo. 


Crear un hilo con la claseThread 


"Bien", dice el programador novato, "Sé que puedo crear un nuevo hilo 
utilizando la interfaz Runnable...""O bien", decimos, "utilizando la clase 
Thread". "¡Explíqueme más!", dice el PN. 

La clase Thread soporta nuevos hilos. También implementa la interfaz 
Runnable, por lo que no tendremos que hacerlo. Aquí tiene el diagrama de 
herencia para Thread: 


La tabla 21.1 muestra los campos para la clase Thread, la tabla 21.2 sus 
constructores y la tabla 21.3 sus métodos. 


Tabla 21.1. Campos de la clase Thread. 


Descripción 


static int MAX-PRIORITY 


Laprioridad máxima que puedetener 
un hilo. 


static int MIN-PRIORITY Laprioridad mínima que puedetener 
un hilo. 
static int NORM-PRIORITY La prioridad predeterminada asigna- 


da a un hilo. 


Tabla 21.2. Constructores de la clase Thread. 


| Constru ctor Descripción 
Thread() Construye un nuevo objeto Thread. 
Thread(Runnab1etarget) Construye un nuevo objeto Thread 


utilizando un objeto Runnable. 
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Constructor Descripción 


Thread(Runnab1etarget, String name) Construye un nuevo objeto Thread 
con un objeto Runnable y un nombre. 


Thread(String name) Construye un nuevo objeto Thread 
con un nombre. 


Thread(ThreadGroup group, Runna- Construye un nuevo objeto 
ble target) Thread como parte de un grupo. 


Thread(ThreadGrOupgroup, Runnable Construye un nuevo objeto Thread 

target, String name) con un objeto Runnable. Este objeto 
Threadtiene el nombre especificado 
y pertenece al grupo de hilos al que 
hace referencia group. 


Thread(ThreadGroup group, String Construye un objeto Thread que es 
name) parte de un grupo y tiene nombre. 


Tabla 21.3. Métodos de la clase Thread 


Método Descripción 


static int activeCount() Obtiene el número actual de hilos 
activos en el hilo del grupo de hilos. 


void checkAccess() Determina si el hilo actualmente en 
ejecución tiene permiso para modi- 
ficar este hilo. 


int countStackFrames[) Obsoleto. La definición de esta lla- 
mada depende de suspendo, que | 
está obsoleta. 


static Thread currentThreaq() Obtiene una referencia al objeto 
Thread actualmente en ejecución. 

void destroy () Destruye este hilo. 

static void dumpStack() Imprime una traza de la pila del hilo | 
actual. | 


static int enumerate(Thread[] tarray) Copia a la matriz indicada todos los | 
hilos activos en el hilo del grupo de 
hilos. 


ClassLoadergetContextClassLoader() Obtiene el contexto ClassLoader 
para este hilo. 


String getName() Obtiene el nombre del hilo. 


| int getPriority() Obtiene la prioridad del hilo. 


Método Descripción 


| ThreadGroup getThreadGroup0 Obtiene el grupo de hilos al que 


pertenece este hilo. 


void interrupto Interrumpe este hilo. 

static boolean interruptedo Devuelve true si el hilo actual ha 
sido interrumpido. 

boolean isAlive() Devuelve true si el hilo está vivo. 

boolean isDaemon() Devuelve true si este hilo es un hilo 
demonio. 

boolean isinterrupted() Devuelve true si éste hilo ha sido 
interrumpido. 

void join() Espera hasta que muera este hilo. 

void join(long millis) Espera al menosmillismilisegundos 


para que este hilo muera. 


void join(long millis, int nanos) Espera al menosmillismilisegundos 
másnanosnanosegundos para que 
este hilo muera. 


void resume() Obsoleto. Este método existe única- 
mente para utilizar con suspend, 
que ha quedado obsoleto. 


void run() Si este hilo fue construido con una | 
interfaz Runnable de un objeto run 
separado, se llama al método run 
del objeto Runnable. 


void setContextClassLoader(Class-  Asignaelcontexto ClassLoaderpara 


Loader cl) este hilo. 

void setDaemon(boo1eanon) Marca este hilo como hilo demonio 
o hilo de usuario. 

void setName(String name) Cambia el nombre de este hilo para 
que sea igual al nombre del argu- 
mento. 

void setPriority(int newpriority) Cambia la prioridad de este hilo. 

static void sleep(long millis) Hace que el hilo en ejecución actual- 


mente duerma durante el número 
indicado de milisegundos. 
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Método 


void start() 


void stop() 
void stop(Throwable obj) 


void suspendo 


String toString() 


static void yield() 


static void sleep(long millis, int nanos) 


Descripción 


Hace que el hilo en ejecución actual- 
mente duerma durante el número 
indicado de milisegundos más el 
número indicado de nanosegundos. 


Hace que este hilo comience su eje- 
cución, lo que hace que la máquina 
virtual Java llame al método run de 
este hilo. 


Obsoleto. Este método es conside- 
rado inherentemente inseguro. 


Obsoleto. Este método es conside- 
rado inherentemente inseguro. | 


Obsoleto este método ha quedado 
obsoleto debido a que se considera 
propenso a bloqueos inherentemen- 
te. 


Obtiene una representación de 
cadena de este hilo. 


Hace que el objeto Thread en ejecu- 
ción actualmentese detengatempo- 
ralmente, lo que puede permitir que 
otros hilos se ejecuten. 


Aquí tiene un ejemplo en el que creamos un segundo hilo y hacemos quG 
imprima su nombre diez veces, una por segundo. Observe que, en este caso, 
estamos llamando al constructor del hilo y pasándole el nombre del segundo 
hilo para, después, llamar al método start del hilo para iniciar la ejecución del 
código en el método run. La acción tiene lugar en el método run; ahí es donde 
el hilo imprime su nombre cada segundo. Aquí tiene el código: 


class SecondThread extends Thread 


( 
SecondThread() 


{ 


s~per (~segundo~); 


start ()5 
1 


public void run() 


{ 
trY € 


for (int loop—index = 0; loop—index < 10; Jloop-index++) ( 
“-stem.out.println((Thread.currentThread ()) .getName-) 
+ =" hilo aquí..."); 
Thread. sieep (1000); 
1 
1 catch (-“-nterruptedExce-tian Cl 


system.out .println ("Segundo hilo finalizando..); 
1 


Aquí tiene una aplicación en la que utilizamos la clase Thread y también 
imprime el nombre del hilo principal cada segundo: 


class thread 
I 
public static void main (String args[1) 


{ 


SecondThread secondthread = new SecondThreado; 


try ( 
for (int loop—index = 0; loop—index < 10; loop-index++) I 
System.out.println((Thread.currentThread()) .getName-) 
+ " hilo aquí..."); 
Thread.sleep (1000); 
1 


) catch (InterruptedExceptione) Il 


1 


Aquí tiene el resultado de este código (thread-javaen el CD). Observe que 
ambos hilos están funcionando y visualizan sus nombres, una vez por segun- 
do: 


c:\zjava thread 
Iniciando segundo hilo 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
main hilo aquí... 


segundo hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
Final del segundo hilo 


Crear hilos múltiples 


"Sé que puedo iniciar un segundo hilo", dice el programador novato, 
"pero, ¿qué tal si inicio cuatro nuevos hilos?". Sonreímos y contestamos, 
"No hay problema”. 

Puede crear y ejecutar múltiples hilos en un programa; basta con dar a 
cada hilo un nuevo objeto. Aquí tiene un ejemplo en el que creamos cuatro 
hilos y hacemos que cada uno imprima su nombre una vez por segundo: 


class CustomThread extends Thread 
CustomThread (String name) 
I 
super (name); 
start () ; 
1 


public void run () 


( 
try ( 
for (int loop—index = 0; loop—index c 4; loop-index++) [ 
System.out.println( (Thread.currentThread0).getNameo 
+ "hilo aquí..."); 
Thread.sleep (1000); 
1 
} catch (InterruptedExceptione) [) 


System.out.println ((“-hread.currentThread ()) .getName ()+ ' fina- 


ciass multithread 
I 
public static void main (String args[1) 


I 


CustomThread threadl new CustomThread ("primero"); 
CustomThread thread2 = new CustomThread ("segundo"); 
CustomThread thread3 = new CustomThread ("tercero"); 
CustomThread thread4 = new CustomThread ("cuartoV; 


try ( 
for (int loop—index = 0; loop—index < 10; loop-index++) 
System.out.printin ((Thread.currentThread0).get~ameo 
+ "hilo aquí...”"); 


Thread.sleep (1000); 
1 
j catch (InterruptedExceptione) {} 


1 


Aquí tiene el resultado de este código (multithread-java en el CD): 


primero hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
cuarto hilo aquí... 
tercero hilo aquí... 
primero hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
cuarto hilo aquí... 
tercero hilo aqui... 
primero hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
cuarto hilo aqui... 
tercero hilo aquí... 
primero hilo aquí... 
main hilo aquí... 
segundo hilo aquí... 
cuarto hilo aquí... 


Espera (para unión) de hilos 


"Necesito más control sobre los hilos”, dice el programador novato. "Por 
ejemplo, necesito ser capaz de esperar hasta que un hilo termine la ejecución 
antes de seguir con el resto del programa. ¿Existe alguna forma de compro- 
barlo?". "Claro", decimos, "puede utilizar el método join para esperar hasta 
que un hilo termine”. "¿De verdad? ", pregunta interesado el PN. 

El método join de la clase Thread espera hasta que se termine la ejecución 
de un hilo (también conocido como espera hasta la muerte de un hilo) antes 
de retomar. Aquí tiene un ejemplo en el que creamos cuatro nuevos hilos y 
esperamos a que termine cada uno antes de finalizar la aplicación principal: 


class CustomThread extends Thread 
{ 

CustomThread (String name) 

{ 


super (name); 
start () ; 
1 


public void run0 
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try ( 
foríint loop—index = 0; loop—index < 4; loop-index++) { 
System.out.println((Thread.currentThread0) .getName () 
" 


+ hilo Aaquis. "7 
Thread.sleep (1000); 


} 


l catch (InterruptedExceptione) {} 


System.out.println( (Thread-currentThreadgetName + ' fina- 
liza."); 
1 
1 


class join 
{ 
public static void main (String args[1) 
{ 
CustomThread threadl 
CustomThread thread2 
CustomThread thread3 
CustomThread thread4 


new CustomThread ("primerM); 
new CustomThread ("segundo"1; 
new CustomThread ("tercero"); 
new CustomIhread ("cuarto"); 


try ( 
threadl.join0; 
thread2.join() 
thread3.joiní); 
thread3.joino; 

j catch (InterruptedExceptione) [) 


1 


Aquí tiene la salida de este código (join-javaen el CD): 


c:iX>Java join 
primer hilo aquí... 
segundo hilo aquí... 
tercero hilo aquí... 
cuarto hilo aquí... 
primer hilo aquí... 
segundo hilo aquí... 
tercero hilo aquí... 
cuarto hilo aquí... 
primer hilo aquí... 
segundo hilo aquí... 
tercero hilo aquí... 
cuarto hilo aquí... 
primer hilo aquí... 
tercero hilo aquí... 
segundo hilo aquí.. 
cuarto hilo aquí... 
primer finaliza. 
tercero finaliza. 
segundo finaliza. 
cuarto finaliza. 


Comprobar que un hilo está vivo 


"Oh, oh", dice el programador novato, "he perdido el hilo. ¿Cómo sé si 
todavía está realizando algo?. "Ningún problema en absoluto", decimos. "Para 
comprobar un hilo, puede utilizar su método isAlive para ver si el hilo 
todavía está activo”. "¿Cómo funciona?", pregunta el PN. 

Aquí tiene un ejemplo en el que creamos y ejecutamos cuatro nuevos 
hilos. A medida que los hilos se ejecutan, utilizamos el método isAlive del 
primer hilo nuevo y, cuando todos los hilos han terminado (lo que verifica- 
mos con el método join), comprobamos de nuevo ese proceso con isAlive. 
Aquí tiene el código: 


class CustomThread extends Thread 


{ 


CustomThread (String name) 
{ 

super (name); 

start ():; 


public void run() 
{ 
try ( 
foriint loop—index = 0; loop—index c 4; loop-index++) { 
Systern.out.println( (Thread.currentThread0) .getName () 
+ " hilo aquí..."); 
Thread.sleep (1000); 


) 
) catch (InterruptedExceptione) {) 


System.out.println( (Thread.currentThread .getName()+ " fina- 
liza."); 
} 
1 


class isalive 
I 
public static void main (String args[]) 
( 
CustomThread threadl 
CustomThread thread2 
CustomThread thread3 
CustomThread threadl 


new CustomThread ("primer$ 
new CustomThread ("segundo"); 
new CustomThread ("tercero"), 
new CustomThread ("cuarto"); 


System. cut. printin(tbresadi.isalivaidis 


try I 
threadl. join() 
thread2.join(); 
thread3.join (); 
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thread3.j3oin () ; 
} catch (InterruptedExceptione) [) 


Syatam. cut. .princinitbreadi.isAliveill; 


Aquí tiene la salida de este código (isalive.javaen el CD). Observe que el 
valor que devuelve isAlive, es true cuando threadl está en ejecución y false 
después de que el proceso haya salido: 


c:X>javaisalive 
true 

tercero hilo aqui... 
cuarto hilo aquí... 
primer hilo aquí... 
segundo hilo aquí... 
tercero hilo aquí... 
cuarto hilo aquí... 
primer hilo aquí... 
segundo hilo aquí... 
tercero hilo aqui.. 
cuarto hilo aquí... 
primer hilo aquí... 
segundo hilo aquí... 
tercero hilo aquí... 
cuarto hilo aquí... 
primer hilo aquí... 
segundo hilo aquí... 
tercero finaliza. 
cuarto finaliza. 
primer finaliza. 
segundo finaliza. 
false 


Asignar la prioridad y detención de hilos 


"Mmh", dice el programador novato, "sé cómo suspender hilos, pero hay 
un problema. Estoy trabajando en el nuevo programa Super- 
DuperMultiThreadedDataCrunchy algunas tareas son más importantes que 
otras. Por ejemplo, quiero descargar imágenes que el usuario ha solicitado 
antes de realizar una comprobación gramatical en segundo plano”. "Bien", 
decimos, "puede dar a los hilos distintas prioridades". El PN dice: "¡Explí- 
quemelo!". 

Cada hilo en Java tiene una prioridad, que está entre Thread.MAX- 
PRIORITY y Thread.MIN-PRIORITY. Aquí tiene las prioridades que están 
definidas actualmente: 


e MAX-PRIORITY. La prioridad máxima que puede tener un hilo. 
e MIN-PRIORITY. La prioridad mínima que puede tener un hilo. 
e NORM-PRIORITY. La prioridad predeterminada asignada a un hilo. 


El valor de Thread-MAX-PRIORITY es 10, Thread.MIN-PRIORITY es 
uno y NORM-PRIORITY es5. 

La asignación de prioridades es una tarea muy complicada debido a que 
depende del sistema operativo y los resultados reales dependen en gran mane- 
ra de otras aplicaciones que se ejecuten al mismo tiempo. De todas formas, 
puede asignar las prioridades relativas de los hilos. Aquí tiene un ejemplo en 
el que proporcionaremos cuatro diferentes prioridades a cuatro hilos y les 
haremos que cuenten durante cinco segundos. Entonces los finalizaremos y 
visualizaremos su resultado para obtener una indicación de la velocidad de 
ejecución relativa. Aquí tiene el código (observe que para los hilos, utiliza- 
mos un semáforo que se comprueba en el método run y queda definido como 


volatile, lo que significa que su valor puede ser cambiado por cualquier otro 
hilo): 


class Counter implements Runnable 
I 

Thread thread; 

int counter = 0; 

volatile boolean goflag; 


public Counter (int p) 

I 
thread = new Thread (thi6); 
thread. setPriority (p); 

1 


public void starto0 
I 
goflag = true; 
thread. start ()5 
1 


public void run0 
I 
while (goflag) counter++; 
1 
public void end() I 
goflag = false; 
1 
1 


class priority 
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public static void main (String args[]) 

{ 
Counter threadl new Counter (Thread.NORM-PRIORITY + 2); 
Counter thread2 new Counter(Thread.NO-PRIORITY + 1); 
Counter thread3 = new Counter(Thread.NO-PRIORITY  ” 1); 
Counter threadl r new Counter (Thread.NORM-PRIORITY ” 2); 


threadl.start () 5 
thread2.start () 5 
thread3.starto; 

thread4.start () 5 


tey [ 
Thread. sleep (5000) ; 
1 catch (InterrupteBExceptione) {1 


Ebreadl endi jy 
tEhrsadi andi }r 
thesad3.and( F 
thresdi endi )p 


Sy~tem.out .println(-iiil01 contado: + threadl.counter); 
Sy~tem.out.println(~~il1@ contado: m + thread2.counter); 
System. out .println(.Hilo 3 contado: " + thread3.counter) ; 
System.o-t.println(-iiil04 contado: pe thread4.counter); 


Para detener los hilos, llamamos al método end personalizado, que asigna 
a un indicador llamado goFlag el valor false. El cual, a su vez, detiene el 
código en el método run. 

En los primeros días de Java, se podía detener un hilo con el método 
integrado stop, pero ese método ha quedado obsoleto ahora, debido a que no 
es seguro; puede dejar que el sistema operativo acceda a los monitores en un 
estado no estable. 

En su lugar, para detener un hilo, puede utilizar ahora el método preceden- 
te, es decir, comprobar algún indicador que pueda asignar desde fuera del 
hilo. 

Aquí tiene la salida de este código (priority.java en el CD). Observe el 
distinto número de cuentas para los hilos con distintas prioridades (sus resul- 
tados pueden variar, por supuesto, dependiendo de su sistema operativo y la 
velocidad de la máquina): 


c:il>java priority 

Hilo 1 contado: 258865319 
Hilo 2 contado: 239589379 
Hilo 3 contado: 27347113 
Hilo 4 contado: 25558903 


¿Por qué utilizar la sincronización? 


"Bien", dice el programador novato, "creo que no quiero usar más hilos. 
Tengo un objeto que almacena los datos de mi programa y no puedo tener 
muchos hilos distintos trabajando con el mismo objeto a la vez; ¿qué sucede 
si un hilo cambia parte del objeto de datos y después otro hilo cambia la 
misma parte del objeto de datos antes de que el primer hilo haya terminado? 
¡El caos!” "Bien", sonreímos, "puede impedir que los nuevos hilos trabajen 
con objetos como ese hasta que el hilo actual haya terminado, sincronizando 
sus hilos". "¡Vaya!” dice el PN. 

Excluir otros hilos de una operación hasta que la operación se haya com- 
pletado se conoce como sincronización. Aquí tiene un ejemplo que muestra 
por qué resulta útil la sincronización. En este caso, tenemos cuatro nuevos 
hilos que trabajan todos con un objeto de datos compartido. Este objeto 
imprime un mensaje de inicio y un mensaje de fin y completa una tarea de 
medio segundo entre los mensajes. Realmente, el objeto de datos debería 
iniciarse, realizar su tarea y terminar antes de que el siguiente hilo inicie una 
nueva tarea, pero ésa no es la forma en que trabajamos aquí; cada hilo 
bloquea el objeto de datos para sí mismo. Aquí tiene el código: 


class synchronizel 

{ 
public static void main(String args[ll 
I 


Shared shared = new Sharedo; 


CustomThread threadl = new CustomThread (shared, "uno"); 
CustomThread thread2 = new CustomThread (shared, "dos"); 
CustomThread thread3 = new CustomThread (shared, "tres"); 
CustomThread thread4 = new CustomThread (shared, "cuatro"); 


try l 
threadl.join(); 
thread2. join(); 
thread3.join0; 
thread4.join(); 

} catch(l1nterruptedException e) {} 


class CustomThread extends Thread 
I 


Shared shared; 


public CustomThread (Shared shared, String string) 
{ 


super (string); 


this-shared= shared; 
startoO; 
1 


public void runí) ( 
shared.doWork (Thread.currentThread0 .getNameo0); 
1 


class Shared 


{ 
void doWork (String string) 


System. out .println ("Iniciando " + string); 


try { 
Thread. sleep ((long) (Math.random0 $ 500)); 


} catch (InterruptedException e) {} 
System.out .println ("Terminando " + string); 
1 


Aquí tiene la salida de este código (synchronizel.java en el CD). Observe 
que cada tarea se superpone con las otras: 


c: \>java synchronizel 
Iniciando dos 
Iniciando tres 
Iniciando cuatro 
Iniciando uno 
Terminando cuatro 
Terminando dos 
Terminando uno 
Terminando tres 


He aquí un problema si está trabajando con los datos reales: ¿qué sucede si 
lee algún dato del objeto de datos, o trabaja con él y lo rescribe, pero otro hilo 
ya ha realizado la misma cosa? Cuando escribimos los datos, los cambios 
realizados por otro hilo se perderán. Como puede ver, es importante ser capaz 
de bloquear el acceso a otros hilos para los recursos críticos en un momento 
dado. Examine los siguientes dos temas para ver cómo funciona esto. 


Sincronizar bloques de código 


"Bien", dice el programador novato, "sé que puede existir un problema 
cuando múltiples hilos acceden al mismo objeto o recurso, pero, ¿cómo 
bloqueo el acceso a nuevos hilos hasta que el actual haya terminado con ese 


recurso u objeto?" "Existen dos formas", decimos. "Bien", dice el PN, "¡cuál 
es la primera?”". 

Existen dos formas de sincronizar la ejecución del código de hilos: la 
sincronización de bloques de código y los métodos sincronizados. Examina- 
remos los bloques sincronizados de código en este tema y los métodos 
sincronizados en el siguiente. Para sincronizar un bloque de código, utiliza- 
mos la palabra reservada synchronize, indicando el objeto al que queremos 
restringir el acceso. Si extendemos el ejemplo del tema previo, el proceso 
tiene la siguiente apariencia: 


class synchronize2 


{ 


public static void main (String argsi]) 


{ 


Shared shared = new Shared() ; 


CustomThread threadl = new CustomThread (shared, "uno"); 
CustomThread thread2 = new CustomThread (shared, "dos"); 
CustomIhread thread3 new CustomThread (shared, "tres"); 
CustomThread threadl = new CustomThread (shared, "cuatro"); 


try I 
threadl.join0; 
thread2.join() 
thread3.join() ; 
threadl. joiní) ; 

} catch(1nterrupted-xceptione) O 


class CustomThread extends Thread 
Shared shared; 


public CustomThread (Shared shared, String string) 
( 

super (string) ; 

this.shared = shared; 

start (1; 


public void run0 ( 
eynchronized (share8) { 
shared.do-ork (Thread.currentThread0. getNameo0); 
1 


class Shared 


{ 
void doWorklString string) 


{ 


System.out.println("Iniciando + string); 
try I 

Thread.sleep ( (long) (Math.random0 * 500)); 
1 catch (InterruptedExceptione) {} 


System. -ut.println(-Finalizandó + string); 
1 


Aquí tiene la salida de este código (synchronize2.java en el CD). Observe 
que cada tarea se inicia y termina antes de que cualquier otro hilo inicie una 
nueva tarea: 


c:X>java synchronize2 
Iniciando uno 
Finalizando uno 
Iniciando dos 
Finalizando dos 
Iniciando tres 
Finalizando tres 
Iniciando cuatro 
Finalizando cuatro 


Métodos sincronizados 


Además de los bloques de código sincronizados (tema anterior), también 
puede bloquear el acceso a otros hilos sincronizando métodos. En este caso, 
utilice la palabra reservadasynchronize cuando defina un método. Aquí tiene 
la forma de modificar el método doWork en el objeto shared del ejemplo del 
tema anterior al previo para sincronizar los hilos: 


class synchronize3 

I 
public static void main (String args[1) 
I 


Shared shared = new Sharedo; 


CustomThread threadl 
CustomThread thread2 
CustomThread thread3 
CustomThread threadl 


new CustomThread (shared, "uno"); 
new CustomThread (shared, "dos"); 
new CustomThread (shared, "tres"); 
new CustomThread (shared, "cuatro"); 


try I 
threadl. join Í); 
thread2.join0; 
thread3. join Í); 
threadl. join0; 
} catch(1nterruptedExce-tione) (1 


class CustomThread extends Thread 


( 
Shared shared; 


public CustomThread (Shared shared, String string) 
{ z 

super I string) ; 

this.shared = shared; 

start Í); 


public void run() { 
shared.doWork (Thread.currentThread () .getName-)); 


1 


class Shared 


{ 


synchronized void tioworkíString string) 


( 


System.out .printlní"lniciando + string); 
try I 

Thread.sleep( (long) (Math.random() ° 500))5 
} catch (InterruptedExceptione) {} 


System.out .printlni"Finalizando + string); 


1 


Ahora, únicamente un hilo cada vez puede entrar en el método doWork. 
Aquí tiene la salida de este código (synchronize3,java en el CD): 


c:X>java synchronize3 
Iniciando uno 
Finalizando uno 
Iniciando dos 
Finalizando dos 
Iniciando tres 
Finalizando tres 
Iniciando cuatro 
Finalizando cuatro 


Comunicación entre hilos 


"Maldición", dice el programador novato, "tengo un problema con los 
hilos. Parte de mi programa está escribiendo datos y parte leyéndolos; pero 
¡unas veces la parte de lectura se adelanta a la parte de escritura!". "Ese es un 


Yar 


problema clásico de producción/consumición", decimos, "y puede arreglarlo 
con los métodos wait y notify". El PN sonríe y dice, "¿Sí?". 

A veces, los hilos necesitarán combinarse entre ellos, especialmente cuan- 
do la salida de un hilo se utiliza en otro hilo. Una forma de coordinar estos 
hilos es utilizar los métodos notify, wait y notify All: 


e wait. Hace que un hilo duerma hasta que se llame a notify o notify All en 
el mismo objeto. 


e tzotify. Inicia el primer hilo que llamó a wait en el mismo objeto. 


e notifyAll. Inicia todos los hilos que llamaron a wait en el mismo objeto. 


El procedimiento habitual para el hilo de lectura será llamar a wait, y para 
el hilo de escritura llamar a notify, cuando los datos que desea leer el lector 
estén listos. Aquí tiene un ejemplo. En este caso, un hilo de escritura llamará 
al método doWork del objeto, que es un método que consume tiempo, escribe 
algún dato, y un hilo lector llamará al mismo método getResult del objeto 
para leer los resultados. Queremos que el hilo lector tenga que esperar hasta 
que doWork haya terminado. Por tanto, todo lo que tenemos que hacer es 
llamar a wait en getResult para hacer que el lector espere y llame a notify en 
doWork cuando el hilo que escribe termine y los datos estén listos para la 
lectura. Aquí tiene la apariencia del código: 


class Shared 
int data = 0; 


synchronized void doWorko0 
c 
trY ( 
Thread. sleep (1000); 
1 catch (1nterruptedException e) {} 


data = 1; 
notify O; 
1 


synchronized int getResult0 ( 
trY { 
wait ()5 
} catch(linterrugted-xceptione) () 
return data; 


1 


class CustomThreadl extends Thread 
( 


Shared shared; 


public CustomThreadl (Shared shared, String string) 
I 

super (string); 

this.shared = shared; 

start O ; 


public void run() { 
System.out.println("El resultado es 


+ shared.getResultO0); 
1 


class CustomTIhread2 extends Thread 


( 
Shared shared; 


public CustomThread2 (Shared shared, String string) 
I 

super (string) ; 

this.shared = shared; 

start () ; 


public void run0 { 
shared.doWork0; 
1 


class wait 
I 
public static void main (-tringargst]) 
I 
Shared shared = new Sharedo; 
CustomThreadl threadl = new CustomIhreadl (shared, "uno”); 
CustomThread2 thread2 = new CustomIhread2íshared, "dos"); 


Aquí tiene la salida de este código (wait.java en el CD). Observe que el 
hilo de lectura espera realmente hasta que el hilo que escribe haya terminado: 


c:\>javawait 
El resultado es 1 


Suspender y reanudar hilos 


Anteriormente, los hilos en Java soportaban tanto el método suspend 
como el resume, que se podían utilizar para detener e iniciar de nuevo tempo- 


ralmente un proceso. Desgraciadamente, como sucede con el método stop, 
tanto suspend como resume han sido descatalogados. En este caso, estos 
métodos se han descatalogado debido a que eran propensos al bloqueo y 
podían bloquear el acceso a otros hilos. No obstante, puede crear su propio 
método suspend y resume y mostraremos cómo hacerlo aquí. 

Observe que cuando subclasifica la clase Thread, no puede llamar a sus 
nuevos métodos de reanudación suspend y resume, debido a que Java se 
quejará de que intente sobrescribir métodos descatalogados. Por tanto, en 
este ejemplo, llamaremos a estos métodos newsuspendy newResume (esto no 
es un problema cuando se trabaja con un objeto que implementa, en cambio, 
la clase Runnable). Como es el caso en que implementa un nuevo método 
stop (consulte el tema correspondiente en este mismo capítulo), estos méto- 
dos trabajan asignando un indicador que se comprueba en el método run. 
Cuando asignamos ese indicador al valor true en newsuspend, utilizamos el 
método wait del método run para suspender el hilo y reanudar el hilo de 
nuevo con el método notify en el método newResume. Aquí tiene la aparien- 
cia del código: 


class CustomThread extends Thread 


{ 


volatile boolean goFlag = true; 


CustomThread (String name) 
( 

super (name) 5 

start (); 


public void run0 
I 
try 
for (int loop—index = 0; loop—index <= 5; loop-index++) ( 
System.out.println(Thread.currentThread() .getName () + 
aquí..."); 
Thread.sleep (500); 
synchronized (this) ( 
while (1goFlag) < 
wait ()5 
1 


1 


l catch (InterruptedExceptione) () 


public void newSuspendO 


{ 
goFlag = falsa; 
1 


synchronized public void newResume() 


goFlag = true; 
notifyí); 


class suspend 


{ 


public static void main (String args[]) 

{ 
CustomThread threadl = new CustomThread ("uno"); 
CustomThread thread2 = new CustomThread ("dos"); 


try { 
Thread. sleep (1000) ; 
System. ~ut .println (-Suspendiendáilo wo..."); 
threadl.newSuspendO; 
Thread.sleep (1000); 
System.o-t.println (“Resumiendo hilo uno..."); 
threadl. newFtesume () 5 

j catch (InterruptedExceptione) {} 


try ( 
threadl.jJoin0; 
thread2.join():; 
j catch (InterruptedExceptione) {} 


) 


Aquí tiene la salida del código (suspend-java en el CD). Observe que los 
hilos uno y dos se ejecutan hasta que el código suspende el hilo uno; entonces 
cuando el código inicia de nuevo el hilo uno, alternan otra vez: 


c:1> Java suspend 

uno aquí... 

dos aquí... 

uno aquí... 

dos aquí... 
Suspendiendo hilo uno. 
dos aquí... 

dos aquí... 

Resumiendo hilo uno... 
uno aquí... 

dos aquí... 

uno aquí... 

dos aquí... 

uno aquí... 

uno aquí... 


Crear gráficos animados con hilos 


"Digamos", dice el programador novato, "que he pensado algo, utilizar 
hilos es ideal cuando quieres dar soporte a animación de gráficos, ¿verdad?". 


"Así es", decimos. "Fantástico", dice el PN. "Escriba el código, que yo 
miraré". 

Aquí tiene un ejemplo que muestra cómo puede funcionar la animación de 
gráficos utilizando hilos. En este applet, cargamos cuatro imágenes en una 
matriz de imágenes y después realizamos un ciclo a través de ellas en el 
método paint, haciendo que Java llame a ese método repetidas veces llaman- 
do a repaint en un nuevo hilo. 

Existe un punto interesante aquí; aunque el método stop de la clase Thread 
ha sido descatalogado, los navegadores y el appletviewer de Sun todavía 
llaman a este método cuando la página que contiene el applet ya no es la 
actual. Para detener el hilo de animación del applet y que no utilice recursos 
del sistema hasta que el navegador decida descargarlo, puede situar código en 
el método stop; pero eso significa que no puede basar su código en la clase 
Thread, debido a que stop está descatalogado allí. Por tanto, escribiremos un 
ejemplo utilizando la interfaz Runnable, que no tiene un método stop 
descatalogado. Aquí tiene el código: 


import java.awt.*; 
import java.applet.Applet; 


ya 
<APPLET 
CODE = whirll.class 
WIDTH = 300 
HEIGHT = 300s 
</APPLET> 
*] 


public class whirll extends Applet implements Runnable 


( 


Image whirlImages[l1 = new ImagelL41; 
Image nowImage; 
int whirlrndex = 0; 


Thread whirlThread; 
boolean animateFlag = true; 


public void init () 


( 


whirlImages[0] getImage (getCodeBase0, "whirll.gif"); 
whirlImages[1] = getImage (getCodeBase0, "whirl2.gifM); 
whirlImages [2] getImage (getCodeBase0, "whirl3.gifM); 
whirlImages[3] getImage (getCodeBase0, "whirl4.gif"); 


Il 


public void starto0 

{ 
whirlThread = new ~hread (this); 
whirlThread.start0: 


public void stop() 
( 


animateFlag = false; 


1 


public void run0 
( 
while (animateFlag)( 
nowimage = whirlImages[whirlIndex++]; 
if(whirlindex > 3)whirlIndex -= 0; 
repaint (); 
try (Thread.sleep(200);) 
catch (1nterruptedException e) { ) 
) 
) 


public void paint (“raphicg) 
{ 
if(nowlmage != null) g.drawImage (nowImage, 10, 10, this); 


) 


Al lar 


Figura 21.1. Visualización de una animación gráfica. 


La figura 21.1 muestra el resultado de este código. Este applet hace que la 
imagen que se muestra en la figura rote; el código está en el archivo whirll .java 
en el CD. 

No obstante, existe un problema aquí; he implementado este ejemplo 
como un applet AWT y cada vez que la imagen se pinta de nuevo, el fondo 
que existe debajo de la imagen se pinta también, por lo que la animación 
parpadea mucho. Para arreglar este problema, consulte el siguiente tema. 


033 


Eliminar el parpadeo en animaciones 
gráficas 


"Mmh", dice el programador novato, "ahora puedo crear una animación 
gráfica utilizando hilos, pero seguro que parpadea mucho". "No hay proble- 
ma", decimos. "Basta sobrescribir el método update". El PN pregunta: "¡CómO 
es eso?" 

En la programación AWT, cuando se repinta una imagen, su fondo se 
repinta primero, lo que provoca mucho parpadeo en una animación gráfica. 
La forma de arreglar esto es sobrescribir el método update, que es el que 
realiza el repintado. Cuando se sobrescribe update, el fondo de la imagen no 
se repinta. De hecho, puede hacer más; puede hacer que el método paint 
repinte únicamente el área cubierta por la imagen que quiere volver a pintar, 
utilizando el método clipRect de la clase Graphics, como sigue: 


import Java.awt.*; 
import java.applet.Applet; 


<APPLET 


CODE = whirl2.class 
WIDTH = 300 
HEIGHT = 300 > 


</APPLET> 


F 


public class whirl2 extends Applet implements Runnable 


t 


Image whirl~mages[]= new ImageL41; 
Image nowImage; 

int whirlIndex = O; 

Thread whirlThread; 

boolean animateFlag = true; 


public void initO { 
whir-Images[O] = getImage (getCodeBase0, "whirll.gif"); 
whir-Images[1] getImage (getCodeBase0, "whir12.gifM); 
whir-~magec[2] getimage (getCodeBa~e0,"whir13.gifN); 
whir-~mages[3] = getImage (getCodeBase0, "whirl4.gif"); 


public void start () { 
whirlThread = new -hread (this); 
whirlThread.starto; 

1 


public void stop() { 
animateFlag= faise; 


public void run0 ( 
while(animateFlag)( 
nowImage = whirlImages [whirlIndex++]; 
if(whirlindex > 3)whirlIndex = 0; 
repaint (); 
try (“hread.sleep(200);1 
catch (1nterruptedException e) { ) 


public void paint (Graphics g) 


if(nowlmage!= null) g.drawImage (nowImage, 10, 10, this); 


public void u-date (-raphicg) 


{ 
g.clipRect (10, 10, 280. 280); 


paint (g); 


4 


Ahora la imagen que muestra la figura 21.1 rotará prácticamente libre de 
parpadeo. Este ejemplo se encuentra en el archivo whirl2.java del CD. 


Suspender y reanudar animaciones 
gráficas 


"¿Qué sucede si," dice el programador novato, "deseo suspender y reanu- 
dar una animación gráfica? ¿Puedo hacerlo?". "Claro", decimos, "sin proble- 
ma. Basta utilizar las técnicas estándar de suspensión y reanudación". 
"Fantástico", dice el PN. "Muéstreme cómo". 

Aquí tiene un ejemplo en el cual añadimos botones para suspender y 
reanudar la animación desarrollada en los dos temas previos. Este ejemplo 
utiliza las técnicas de suspensión y reanudación tratadas anteriormente en 
este capítulo (es decir, utiliza un indicador boolean y los métodos wait y 
notify): 

import java.awt.*:; 


import java.awt.event.*; 
import java.applet.Applet; 


7" 
iAPPLET 
CODE = whir13.class 
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a] 


WIDTH = 300 

HEIGHT = 300 > 
c/APPLET> 

*] 


public class whir13 extends Applet implements ActionListener, Runnable 
I 

Image whirlImages[1 = new Image[41; 

Image nowiImage; 

int whirlIndex = 0; 

Thread whirlThread; 

Button suspendButton, resumeButton; 

boolean animateFlag = true; 

boolean goFlag = true; 


public void initO0 


{ 


whirlImages[O] = getImage (getCodeBase0, "whirll.gifM); 
whirlImagec[1] = get-mage (getCodeBase0,"whirl2.gif"); 
whirlIlmages[2] = getImage (getCodeBase0, "whirl3.gif"); 
whirlImages[3] = get-mage (getCodeBase0, "whirl4.gif"); 


suspendButton = new Button ("Suspenderm) ; 
add (suspendButton) ; 
suspendButton.add!ction-istener (this); 
resumeButton = new -utton (“-esumir"); 
add (resumeButton) ; 
resumeButtOn.acia-ction-istener (this); 


public synchronizeci void actionPerformed (ActionEvent e) ( 
if(e.getSource() == suspendButton)( 
goPlag = false; 
1 
if(e.getSource() == resumeButton) { 
goPlag = true; 
notify (); 
1 


public void start () { 
whirlThread = new -hread (this); 
whirlThread.startO0; 


public void stopoO { 
animateFlag = false; 


public void run() 4 
while (animateFlag)j 
nowImage = whirl-=mages[whirl-ndex++1; 
if(whirllindex > 3)whirlIndex = 0; 
repaint () ; 
try I 
Thread.sleep (200); 


synchronized(this)( 
while(!goFlag) 
wait (); 
1 
1 
catch(l1nterruptedException e) { ) 


1 


public void paint (Graphics g) 
( 


if(nowlmage != null) g.drawImage (nowImage, 10, 10, this); 


public void update (Graphics g) 
I 
g.clipRect (10, 10, 280, 280); 


paint (g); 
1 


La figura 21.2 muestra el resultado de este código (whirl3.java en el CD). 


Figura 21.2. Visualización de una animación gráfica con los botones para 
suspender y reanudar. 


Doble buffer 


El proceso de doble bufferes el que permite la creación de imágenes fuera 
de pantalla y el volcado a la misma cuando es necesario, lo que implica que 
no tiene que crear la imagen en el momento en que el usuario la ve. Puede 
crear un buffer gráfico creando un objeto Image y usando después el método 
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getGraphics del objeto para obtener un objeto Graphics para la imagen que 
puede utilizar para dibujar. Aquí tiene un ejemplo que muestra cómo funcio- 
na el doble buffer. Este ejemplo dibuja una sucesión de cajas fuera de panta- 
lla y después las visualiza, creando, de esta forma, una animación: 


import java.awt.* 5 
import Java.applet.Applet; 


public class dbuffer extends Applet implements Runnable 


Image imagel; 

Thread threadl; 
Graphics graphics; 

int loop—index = 0; 
boolean goFlag = true; 


public void init () 

1 
imagel = createlmage (100, 100); 
graphics = imagel.getGraphics0; 


public void starto 

1 
threadl = new Thread(thisl ; 
threadl-starto0; 


public void stop0 
{ 

goFlag = falce; 
1 


public void runo0 
I 
while (goF1lag){ 
repaint(); 
try (Thread.sleep(100);) 
catch(lnterruptedExceptione) () 


public void paint (Graphics g) 


loop—index += 5; 


if(loop-index >= 100) loop—index = 5; 


graphics.setColor (new Color(255, 255, 255)); 
graphics.fillRect(0, 0, 100, 100); 

graphics .setColor (new ColoríO0, O, 0)); 
graphics.drawRect (O, 0, loop—index, loop—index); 


g.drawImage (imagel, 10, 10, this); 


m Creación 
de paquetes, 
interfaces, 
archivos JAR 
y Java Beans 


Crear un paquete 


"Vaya", dice el programador novato, "tengo tantas clases que las cosas se 
han desordenado bastante. ¿Cómo puedo resolver este desorden?" "Bien", 
decimos, "¿porqué no divide las clases en paquetes? Eso le permitirá distri- 
buir sus archivos de clase en una estructura de directorios de forma similar a 
cuando distribuye los archivos porque tiene demasiados. Problema resuelto”. 
"Fantástico", dice el PN. "Cuéntaeme cómo funciona". 

Cuando tenemos varios archivos de clase, es buena idea distribuirlos en el 
disco utilizando una jerarquía de directorios. De hecho, los paquetes Java 
fueron diseñados originalmente para reflejar esa organización de archivos. 
Puede distribuir archivos de clase en unajerarquía de directorios y permitir 
que Java sepa lo que sucede con los paquetes. 

Por ejemplo, si tiene un paquete llamado packagel, que contiene una clase 
app.class, el archivo de clase iría en un directorio llamado packagel, como 
sigue: 


packagel 
app 


Múltiples archivos de clase en el mismo paquete irán en el mismo directo- 
rio: 


packagel 


-appl 
-3.. 2 
—-app3 


Como el directorio packagel se encuentra en una localización que Java 
buscará (consulte el capítulo 1 para obtener más información sobre dónde 
buscará Java los archivos de clase y cómo utilizar la variable de entorno 
Classpath), Java buscará los archivos de clase que utilice como parte del 
paquete en ese directorio. 

Tiene que indicarle a qué paquete pertenece un archivo de clase, utilizan- 
do la sentencia package en su código. Aquí tiene un ejemplo donde creamos 
app.class e indicamos que forma parte de packagel utilizando la sentencia 
package: 


package packagel; 
public clasc app 
I 
public static void main (String[l args) 


I 


System.out.println (";Hola desde Java!"); 


1 


Una vez compilada app.class y almacenada en el directorio packagel, 
podemos entonces importar la clase app en el código con sentencias como la 
siguiente, como haríamos con cualquier otro paquete Java: 


import packagel.*; 
import packagel.app; 


La herramienta de tiempo de ejecución de Java también conoce los paque- 
tes; por tanto, debido a que la clase app.class es una aplicación en sí, pode- 
mos ejecutar esta clase con una línea de comando que especifique el paquete 
de la clase app y utilizando un punto (.) para el separador de directorios: 


c:X> java packagel.app 


De hecho, el separador de paquetespuntoes útil cuando creamos paquetes 
dentro de paquetes; examine el siguiente tema para más detalles. 


Crear paquetes que contienen paquetes 


"Mmh", dice el programador novato, "ya veo que puede poner archivos de 
clase en un paquete asignando la estructura correcta de directorios y utilizan- 
do la sentencia package, pero, ¿qué sucede si tenemos paquetes dentro de 
paquetes? ¿Qué profundidad puede tener la estructura de anidación de paque- 
tes?" "Tan profunda como quieras”, decimos, "es decir, tan profunda como su 
sistema operativo soporte la anidación de directorios". 

Cuando tenemos gran cantidad de archivos de clase, podemos organizar- 
los en una estructura de paquetes bastante compleja, y lo hacemos creando la 
estructura de directorios correspondiente en el disco, incluyendo las estructu- 
ras de subdirectorios dadas. 

Por ejemplo, si quiere que la clase app esté en el paquete package2, que a 
su vez está dentro del paquete packagel, ésta será la estructura de directorios: 


Para crear esta estructura de paquetes en el código, basta utilizar el separador 
de paquetes punto. Aquí tiene un ejemplo: 


package packagel .package2; 


public class app 
I 


public static void rnain (String[l args) 


{ 


Systern.out.println ("iHoladesde Java!"); 


Ahora puede importar la clase app en su código con sentencias como 
éstas: 


import packagel .package2.*; 
irnport packagel.package2.app; 


Debido a que en este caso app ya es una aplicación clase, también puede 
ejecutarla como sigue, especificando la estructura de directorios de paque- 
te: 


c:\> java packagel .package2.app 
;Holadesde Java! 
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"Bien", dice el programador novato, "quiero derivar una nueva clase desde 
dos clases base, pero sé que Java no soporta la herencia múltiple, por lo 
tanto... "Por lo tanto tiene que utilizar interfaces", decimos. 

Hemos utilizado interfaces a lo largo de este libro y examinaremos cómo 
crear una ahora. Cuando creamos una interfaz, especificamos los métodos de 
la interfaz y cuando la implementamos, proporcionamos el código de estos 
métodos. 


Aquí tiene un ejemplo en el que creamos una interfaz llamada Printem que 
tiene un método: printText. Implementamos esta interfaz en la clase llamada 
classl. Para crear una interfaz, utilizamos simplemente la sentencia interface 
y listamos los prototipos (declaraciones sin cuerpo) de los métodos que 
queremos en la interfaz, como sigue: 


interface Printem 
I 

void printText () ; 
} 


Ahora podemos implementar esta interfaz en class 1: 


interface Printem 


{ 
void printText (); 
1 


public class interfaces 


( 
public static void main (Stringrl args) 
I 
classl objectl = new class10; 
objectl.printText0; 


) 


class classl implements Printem 
I 
public void printText0 
( 
«“ystam.out .println(--Holalesde Javaln); 
1 
1 


Aquí tiene la salida del código (interfaces-javaen el CD que acompaña a 
este libro): 


c:l> java interfaces 
¡Hola desde Java! 


Implementación parcial de una interfaz 


Puede crear clases que implementen parcialmente una interfaz, pero estas 
clases deben declararse abstractas debido a que son únicamente 
implementaciones parciales y, por tanto, no pueden instanciarse en objetos. 

Aquí tiene un ejemplo en el que creamos una interfaz con dos métodos, 
printTextl y printText2: 


interface Printem 
I 
void printTextl (1; 
void printText2() ; 
1 


A continuación, creamos una nueva clase, classl, que implementa la interfaz 
pero únicamente define un método, printText2 (observe que debido a que esta 


clase no es una implementación completa de la interfaz, debemos declararla 
abstracta): 


interface Printem 


( 
void printText1() 


void printText2() 


> 
> 


abstract class classl implements Printem 


{ 
public void printText10 
I 


system.out .printin("~Hola desde Java!"); 


1 


Finalmente, podemos crear una nueva clase, class2, que extienda classl e 
implemente printText2, lo que significa que podemos instanciar objetos de la 
clase class2 como se muestra aquí: 


interface Printem 

I 
void printText1(); 
void printText2(); 


public class interfaces2 
{ 
public static void main (String[l args) 
( 
class2 object2 = new class20 ; 
object2.~rintText2(); 


abstract class classl implements Printem 


( 
public void printText10 


I 
System.out.println("¡Hola desde Java!"); 


class class2 extends classl 
f 
public void printText20 
f 


System.out.println(-ola desde los interfaces Java!"); 
1 
Aquí tiene la salida de este código (interfaces2.java en el CD): 


c:\> Java interfaces2 
¡Hola desde los interfaces Java! 


Observe que las implementaciones parciales pueden ser útiles, como cuando 
desea especificar en qué cantidad (pero no completa) deberían trabajar los 
métodos de una interfaz en una serie de subclases. 


Crear un archivo JAR 


"Vaya", dice el programador novato, "mis archivos de clase están aumen- 
tando de tamaño y hay muchos. ¿Tiene una idea de lo que tardará en descar- 
garse mi applet?" Sonreímos y decimos, "Claro; es por esto por lo que 
debería utilizar archivos JAR". "¿Quéarchivos?", pregunta al PN. 

Un archivo Java (JAR) puede contener varios archivos. De hecho, los 
archivos JAR comprimen sus contenidos utilizando el formato ZIP, por lo 
que si su applet necesita una gran cantidad de archivos grandes, es conve- 
niente crear un archivo JAR. Los navegadores de la red Internet únicamente 
necesitan una conexión en vez de nuevas conexiones para cada nuevo archi- 
vo, lo que puede mejorar los tiempos de descarga. También puede firmar 
digitalmente los archivos de un archivo JAR para probar su origen. 

Creará archivos JAR con la herramienta jar y examinaremos esa herra- 
mienta en esta y las siguientes secciones. Esta herramienta viene con Java y 
aquí tiene su forma de uso: 


Jar [optionsl [manifest]destination input-file[additional input filesl 


Aquí, options son las opciones que puede utilizar con la herramienta JAR 
y son parecidas a las opciones que se utilizan con la herramienta UNIX tar. El 
argumento opcional manifest consiste en el nombre de un archivo manifest, 
que soporta la firma digital y muestra los contenidos del archivo Java. Cuan- 
do cree un JavaBean, utilice un archivo manifest para indicar qué clases son 
Beans (como veremos posteriormente en este capítulo). 

Aquí tiene las opciones posibles que puede utilizar cuando use la herra- 
mienta jar: 


e c. Crea un archivo nuevo o vacío en la salida estándar. 
e t. Muestra la tabla de contenidos en la salida estándar. 


e xfile. Extrae todos los archivos o sólo los nombres de archivos. Si file 
se omite, se extraen todos los archivos; en cualquier otro caso, única- 
mente se extraen los archivos especificados. 


f. El segundo argumento especifica un archivo JAR para trabajar. 


e y. Genera una salida "duplicada" en stderr. 


m. Incluye información manifiesta de un archivo manifest especificado. 
e O. Indica "sólo almacenar", sin utilizar compresión ZIP 


e M. Especifica que un archivo manifest no debería crearse por las 
entradas. 


e u. Actualiza un archivo JAR existente añadiendo o cambiando los 
archivos del manifest. 


e -C. Cambia los directorios durante la ejecución del comando jar. Por 
ejemplo, jar añadiría todos los archivos dentro del directorio clases, 
pero no el propio directorio clases, al archivo jarfile.jar. 


Truco: Puede utilizar un argumento comenzando por el carácte "O" 

para especificar un archivo que contiene argumentos adicionales, con 

tn Rroumento por línea. Estos argumentos se insertan en la lírtea de 
| comandos en la posición del argumento @filenime. 


Aquí tiene el uso típico de la herramienta jar: 


c:\> jar cf jarfile. jar *.class 


En este caso, todos los archivos de clase del directorio actual se sitúan en 
el archivo llamado jarfile.jar. La herramienta JAR genera automáticamente 
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un archivo manifest predeterminado y es siempre la primera entrada del 
archivo Java (por defecto, se llama META-INF/MANIFEST.MPE). 

Si tiene un archivo manifest y quiere que utilice la herramienta jar para un 
nuevo archivo JAR, puede utilizar la opción -m y especificarlo como sigue: 


c:\> jar cm£ manifest.m£t jarfile.jar *.class 


Observe que cuando especifica las opciones cfm en lugar de cmf, necesita 
especificar el nombre del archivo JAR primero, seguido del nombre del 
archivo manifest: 


c:\> jar cfm jarfile.jar manifest.mft *.class 


Observe también que los archivos JAR no son únicamente para archivos 
de clase; pueden almacenar cualquier tipo de archivo. Aquí tiene la forma de 
empaquetar todos los archivos de un directorio en un archivo JAR: 


c:\> jar cfm jarfile.jar manifest .mft a 


Si los nombres de archivo que quiere empaquetar incluían directorios, los 
directorios se buscan de forma recursiva y se almacenan en el JAR los 
archivos. Cuando el archivo JAR se desempaqueta, se recrea de nuevo la 
estructura de directorios. 


Obtener los contenidos del archivo JAR 


"Oh, oh", dice el programador novato, "tengo un archivo JAR y he olvida- 
do el contenido. Supongo que tendré que crearlo de nuevo”. "En absoluto”, 
decimos, "basta con utilizar las opciones tf". "¿Cómo es eso?", pregunta el 
PN. 

Puede determinar el contenido de un archivo JAR con las opciones tf, 
como en este caso, donde el archivo JAR contiene un manifest predetermina- 
do en el directorio interno META-INF y varios archivos de clase: 

c:l> jar tf jarfile.jar 

META- INF / 

META-INF/MANIFEST.MF 

applet.class 

jpanel.class 


newButton.class 
testPanel.class 


Extraer archivos desde un archivo JAR 


"Bien", dice el programador novato, "he utilizado archivos JAR para 
archivar mis archivos; pero, ¿cómo extraigo los archivos de un JAR?" Deci- 
mos, "Con las opciones xf". "¡Genial!", dice el PN. 


Podemos extraer archivos desde un archivo JAR utilizando las opciones 
xf. Por ejemplo, aquí tiene la forma de extraer todos los archivos del archivo 
jarfile-jar introducido en el tema previo: 


c:l> jar xf jarfile. jar 


Al desempaquetar todos los archivos del archivo JAR de esta forma, 
también creamos su estructura original de directorio. En este caso, la herra- 
mienta jar desempaqueta los archivos de clase y también crea un directorio 
llamado META-INF donde coloca el archivo predeterminado rnanifest 
MANIFEST.MF. 

También podemos extraer archivos especificando sus nombres. Aquí tiene 
un ejemplo en el que extraemos applet.class: 


c:l> jar xf jarfile.jar applet.class 
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Apéndice. 
Contenido del 
CD-ROM 


El CD-ROM que acompaña a este libro contiene elementos seleccionados 
específicamente para hacerlo aún más útil. En él encontrará: 


Una versión de prueba de Jbuilder con compatibilidad para Java 2.0 
(PC). 

Una versión de prueba de CoffeeCup HTML Editor, que es un editor 
HTML compatible con Java y GIFs animados (PCILinux). 


Formlayout. Un programa de diseño Java para construir formularios 
profesionales (PC). 


Una versión de prueba de JdesignerPro, que es un sistema integrado con 
todo lo necesario para desarrollar y distribuir aplicaciones basadas en 
exploradores Java (PCILinux). 


Una versión de prueba de SuperMojo, que es la única herramienta RAD 
escrita íntegramente en Java que permite crear aplicaciones y JavaBeans 
(PC). 

Una versión de prueba de Ulead Photoimpact. Se trata de un programa 


de manipulación de imágenes capaz de crear, colorear, corregir y reto- 
car imágenes fotográficas (PC). 


e Una versión de prueba de Ulead Web Razor Pro. Un paquete que 
contiene cuatro estupendas utilidades de optimización, animación, dise- 
ño 3D y administración de imágenes. Web Razor Pro incluye GIF 
Animator 3.0, SmartSaver Pro, COOL 3D 2.0 y Photoexplorer (PC). 


Requisitos del sistema 


Software 


e Su sistema operativo debe ser Windows 95, 98, NT4 o superior. 
e Java Development Kit (JDK), version 1.2.2. 

e Un editor de textos. 

e Beans Development Kit (BDK). 

e Java Servlet Development Kit (JSDK). 


Hardware 


e Un procesador 486DX o más rápido. 


e El requisito mínimo de memoria RAM es 32Mb, pero es recomendable 
utilizar 48Mb. 


e 65Mb de espacio libre de almacenamiento en disco. 
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Modos de selección de lista, 653 
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